K&M Company 
TORRANCE, CA 90503 


_ 


-CUG-CATALL 
CPMUG DIR 
SIGM DIR 
ZUG DIR 
4 file(s). 


CATALOG DISK J(side 1) 


57K 
110K 
209K 
50K 


113 directory entries remaining. 


D>STAT P: 


Bytes Remaining On P: 68k 


D> 

-CATALOG003 
-CATALOGO05 
21 ASC 
ACE BAS 
ACE INT 


AMAZE BAS 
ANIMAL BAS 
BAGELS BAS 
BAGELS2 BAS 
BAS2-0 COM 
BAS2-1 COM 
BIO-FF ASC 
BIOPRINTBAS 
BIORYTH ASC 
BLKFRI BAS 
BLKFRI2 ASC 
BLKFRI2 BAS 
CANNONS BAS 
CHASE BAS 
CHOMP BAS 
COMBINE BAS 
CORE BAS 


More.. 

CORETESTBAS 
CRAPS BAS 
DECISIONASC 
EDTEXT ASC 
EUCLID BAS 
FIB BAS 
FIT BAS 
FORMAT ASC 
FORMAT BAS 


FORMAT FMI 
FORMAT INT 
HANG BAS 
‘HELLO BAS 
KENO BAS 
LANDER’ BAS 


LANES BAS 
LEM BAS 
LOAN BAS 


LOVE BAS 
OTHELLO BAS 
OTHELLO DOC 
PLOT2 BAS 


CATALOG DISK{L(SIDE 2) (temporarly) 

3K 

2K COMBINED CPMUG Vols. 3 & 5 
8K 

2K Plus some interpreted files 
1K 

4k 

2K 

2K 

6K More.. 
12K POET BAS 4K - 
12K POET INT 2K 

5K RADIX ASC 2K 

7K README FMI 6K 

4K RECOVERYASC 1K 
11K RUN2-2 COM 12K 
10K RUN2-3 COM 12K 
lox RUNK2-0 COM 12K 

6K S/TREK BAS 5K 

3K S/TREK INT 3K 

2K SLOT ASC 4K 

1K SORT ASC 2K 

1K , STARS BAS 4K 

STARS INT 2K 
STARTREKASC 7K 

1K {  STARTREKBAS 27K 

4K STARTREKINT 15K 

2K STORY BAS 7K 

6K STRIKE9 BAS 3K 

1K SUPTRK3 ASC 14K 

1K TREKINST 7K 

1K TREKINSTDOC 6K 

2K ; 

4K More.. 

1K TTT BAS 7K 

2K VOLUME3ADOC 8K 

5K VOLUME3BDOC 3K 

5K VOLUMES DOC 1K 

7K WUMPUS' BAS 9K 

5K 71 file(s). 

8K 57 directory entries remaining. 
7K D>STAT P: 

3K 

2K Bytes Remaining On P: 74k 
16K ie rip ease ee 
5K 

2K 


4/10/85 


Derrores: 
2/5/86 


CATALOG DISK 2 (side 1) 


D> Sorted SIGMUG Catalog thru 236 by Extent 
EXT 236 229K 

1 file(s). 

49 directory entries remaining. 

D>stat o: 


Bytes Remaining On O: 12k 


D> CATALOG DISK 2 (side 2) 

D> Sorted SIGMUG Catalog thru 236 by Name 
NAME 236 229K 

1 file(s). 

49 directory entries remaining. 

D>STAT O: 


Bytes Remaining On O: 12k 


D> 


2/11/86 


2/11/86 


POLY-vu 
#PVI19 


K&M Company 


TORRANCE. CA 90503 


er) 


CPMUG vol. 0 10/19/85 
CPMUG DIR 110K 


CPYFST35DOC 28K 
CPYFST3FCOM 2K 
CPYFST3MCOM 2K 
CPYFST3SCOM 2K 
D COM 2K 
FEEDBACKGRL 1K 
FEEDBACKLHS 1K 
FIND COM 1K 
FIND DOC 2K 
HOWTO USE 4K 
PNET DIR 61K 
READMY PJS 12K 
SURVEY COM 2K 
TOMAREK PJS 2K 
U COM 1K 


16 file(s). 

38 directory entries remaining. 
A>STAT O: 

Bytes Remaining On O: 8k 


A> 


spge-DIA0D4 1 CPMHAG OFL 4 cory) 


/ COM _ 8K ape rr 
; CPMUG DIR 110K se 
- CPYFST35DOC 28K 5 
- CPYFST3FCOM 2K Sone Sid thy g : 
~CPYFST3MCOM 2K OLY 
*CPYFST3SCOM 2K 

CRC COM 3K 

DISPLAY COM 2K 

FEE DBACKGRL 1K 

FEEDBACKLHS 1K 
‘FIND COM 1K 
*FIND Doc 2K 
“HOWTO USE 4K 
« PNET DIR 61K 

READMY PJS 12K 
%SURVEY COM 2K 

TOMAREK PJS 2k 

18 filels). 

86 directory entries remaining. 

A> 

STNT Oo: 


by re 


110K’ 


28K 
2K 
2K 
2K 
2K 


cm CPM CPMUG DIR 


41 directory entries remaining. 


Bytes Remaining On O: 1k 


CPMUG DIR 
CPYFST35D0C 
CPYFST3FCOM 
CPYFST3MCOM 
CPYFST3SCOM 
D COM 
“  PIND COM 
FIND DOC 
be HOWTO USE 
¢~ |Y2MDM727 DOC 
Myst PNET DIR 
SURVEY COM 
12 file(s). 
A> 
A>STAT O: 
A> 
oy 
oN 


8/13/85 


TYPE HOWTO.USE 


PUBLIC DOMAIN SOFTWARE DIRECTORY DISKETTE 1 


Following the format established by the Users Groups in 
their release volumes, the files found on this diskette are 
briefly described in the file -PJS-DIR.001. The information on 
this diskette is taken from public domain software volumes 
collected and released by the CP/MUG and PICONET Users Groups. A 
companion diskette, -PJS-DIR.002 contains directories from the 
SIG/M and PASCALZ Users Groups. 


DIRECTORY FILE FORMAT: 


The content and format of the directories as released by 
CPMUG, SIG/M, PASCALZ and PICONET vary considerably. To 
standardize the format on the directory (.DIR) files, the 
original directory formats have been modified to the following 
four fields: 


FILE# FILENAME SIZE CRC DISCRIPTION 


The directory files (CPMUG.DIR and PNET.DIR) on this 
diskette are shortened descriptions of the -Catalog.xxx files 
from each CP/MUG and PASCALZ User Group volume. Descriptions 
have been added where none existed, extraneous verbage has been 
removed from the comments, and in some cases existing wording has 
been clarified. Only one line has been used per file to permit 
better use of FIND.COM. 


HOW TO USE THIS DISKETTE: 


The directory files, CPMUG.DIR and PNET.DIR can be’ console 
displayed or hard printed-out directly, or FIND ( on this 
diskette) can be used to locate the types of program you are 
looking for. We have also included the FAST program (/.COM) to 
expedite your search, however, it may not work reliably with all 
computers, depending on thier speed, so if you have a problem, 
use FIND without FAST (/.COM). To locate a particular file or 
files, type the following: 


/ FIND B: filename.typ string 


This example command string can be broken ‘down into’ the 
following parts for easier understanding: 


/ -. FAST program to expedite searching (optional) 
B: = The drive number on which you want to search 
(optional). If not specified, the default option will be the 


drive you are logged onto. 


<filename.typ> - This is the name of the file (e.g. 
CPMUG.DIR) that you want to be searched. Wild card inputs 
compatible with CP/M are permitted in the filename - (e.g. *.DIR 
will cause all of the .DIR files on the drive specified to be 
searched.) See FIND.DOC for more information. 


<string> - This is the ASCII string to search for in 
the file, <filename.typ>. 


The FIND utility will scan the specified file 
<filename.typ>, looking for lines containing the selected 
'string'. All directory lines (files) which have the selected 
'strina' will be .orinted and/or disvlaved. You mav also search 


use? | 


for particular file names or common words such aS modem, doc, 
pas, bas, game, etc. (any ASCII string found in 'filename.typ') 
To display all of a particular volume, enter the string (e.g. 
'c90' for CP/MUG volume 90, 'PO7' for PICONET volume 07) or use 
just '.' and get all entries on the <filename.typ> file(s) 
displayed. 


EXAMPLE: / FIND CPMUG.DIR MODEM 
(will display all references to MODEM in the 
file CPMUG.DIR) 


If you would like to terminate your search early, a control- 
C will immediately return you to the command level of CP/M. 


KHAEKKEKKEKKKEKEKEKKEKEKERK PNHERERKEKE KERR EKEERKEREREREREKEERE 
O>TYPE FIND.DOC 

Documentation of various original programs written 

by Ward Christensen (CPM/UG 036) 


CPM/UG (086) 
OVERVIEW: 
Finds ASCII, upper case character strings in a file. 
May take a generic file name, thus may search all .ASM files 
on a disk. Also very useful for finding things in MAST.CAT - 
for example if you have multiple VDM routines: VDMSCROL.ASM, 
PRINTVDM.ASM, etc you could FIND MAST.CAT VDM to see them all. 


USAGE: 

find b:*.asm alpha 
will find all occurrences of ALPHA in all .ASM files on B:. 

Used with LIST.COM which takes a Starting line number, 
you can: 1) use find to find a particular part of the code, 
then 2) use LIST specifying a starting line number just before 
the part of the code you wanted to see. 

DEPENDENCIES: 

Note that FIND is a quickie program - it gets the label 
to search for from the second FCB so you can't put some 
special characters in the ASCII string. I.E. 

find b:*.asm in.to 


would find IN (since .to would be put as the filetype). 


O> 


weer 


TYPE CPYFST35.DOC 
COPYFAST.ASM Version 3.5 
for 
IBM 3741 Compatible Diskettes 


(Originally written by: Chuck Weingart ) 
( 2152 W. Iowa 
( Chicago, Ill 60622 ) 


This program is placed in the public domain. Selling or 
licensing of this program is prohibited. (You are encour- 
aged to give it away to all of your friends). If you make 
changes that may benefit others, please send the new 
version to the CPM Users Group, so all may have it. 


Modified: 

Version 1.0; by Chuck Weingart 
October 1980: after the public domain 
Tarbell disk copy program (does not 
require a Tarbell controller) 

Version 1.1; by Kelly Smith 
January 21, 1981: 
( >>>modifications undocumented <<< ) 

Version 1.2; C. Strom 
February 12, 1981: corrected typo 
in OBJMSG when SINGLE true; added 
a CR. 

Version 2.0; by Chuck Weingart 
February 16, 1981: Changed messages added 
in V1.1 and 1.2 back to upper case - some 
people have terminals that dont handle 
lower case. 

Version 2.1; C.W. 
February 18, 1981: added code to check 
console port for Ctrl-C abort condition 
during copy, and misc code to help in 
CP/M 2.2 systems that block and deblock 
from large sectors. 

Version 2.2; C.W. 
February 24, 1981: added auto size check. 
Added interleave table Suitable for very 
fast disk controllers. 

Version 2.3; C.W. 
March 2, 1981: Change all references to 
EXITCP to EXIT so that user gets a chance 
to put in system disk before program re- 
boots CP/M. 

VERSION 3.0; C.W. 
March 6, 1981: Check if given number of 
buffers will overlay the BIOS and reduce 
accordingly. 
Moved comments to DOC file to keep the 
source editable in one pass, and add 
more explanation to the comments on 
sector sizes and read skewing. 

Version 3.1; C.W. 
March 10, 1981: Added TSKEW and code for ceyesr f 
track skewina to increase sneead for fact 


controllers. 
Separated read and write error checking: 
NUMERR now applies to each track read, 
but to each entire write pass. 

Version 3.2; C.W. 
March 18, 1981: Corrected read skew bug 
noticed by Steve Bogolub. Added CR,LF to 
the read and write error messages that 
got deleted in version 1.1 
Added WRSWCH, WRCODE, WRTAB to help solve 
problems with CP/M 2.2 blocking with some 
manufacturers CBIOS routines. 

Version 3.3; C.W. 
March 22, 1981: Added DIFFTRK (ability to 
copy from different tracks) in order to be 
able to unpack UCSD Pascal disks. 

Version 3.4; C.W. 
May 9, 1981: Fix bug in read error recovery 
that caused bad read to repeat forever. 
(Took me two attempts. No branch to TRYRDA.) 
Changed NUMERR to 4. 

Version 3.5; C.W. 
May 16, 1981: Add parameter for specifying 
the range of tracks copied. Removed CRLF 
between source and object messages. Moved 
INIT message to one-time code. Display # 
of buffers used if insufficient space. Echo 
source and object drives. Home drives after 
the copy is complete (to flush buffers). 


Note to subsequent modifiers: 
Please note the specific changes you make to the 
code, so that others can keep track what you have 
done, even if it is just lower case messages. 


This program will copy the data area of one CP/M disk to 
another (thats tracks 2 - 76), as fast as possible. All 
data written is read back to verify that the write was 
successful, and multiple tracks are copied in one pass, for 
speed. The version as supplied assumes that the controller 
CRC checking is sufficient for verification, but an assembly 
option allows complete byte-by-byte comparison on the _ read 
back. It is possible to copy only part of a disk, moving a 
block of tracks from one disk to a different part of another. 


The program as supplied will automatically determine the 
size of the CP/M system and adjust the number of buffers 
accordingly. For example, it can copy four tracks at a pass 
in a minimum (16K) system, and 18 tracks at a pass in a max- 
imum system (64K). A fixed-buffer option is also available: 
the number of track buffers, and hence the minimum size, can 
be changed to suit your system. Only standard CP/M CBIOS 
calls are used to access the disk, no BDOS calls, so the 
BDOS and CCP can be overlaid by the track buffers. No other 
CP/M functions are assumed. North Star CP/M or UCSD Pascal 
users should be able to modify this program easily to run on 
their systems. 


COPYFAST will allow a disk to be copied on a_one-drive 
system, as an assembly option. A version with 18 buffers 
(64K) will require only 5 complete swaps. 


ervest ©. 


Three assembled versions of the program are supplied, for 
your convenience. They are called CPYFST3F.COM for very 
fast disk controllers (such as CCS 2422), CPYFST3M.COM for 
controllers (such as Micromation) that cannot write a track 
in one revolution, and CPYFST3S.COM for controllers (such as 
Versafloppy) that must interleave both reads and writes. I 

r=] recommend that you try each of the three programs to see how 
fast they run on your system. The only difference between 
them is the read and write interleave. All three versions 
do read-after-write checking and automatically determine the 
number of buffers to use in the copy. If all three COM 
files run very slowly you may have a slow controller or an 
inefficient CBIOS, and it will be necessary to examine this 
documentation closely and edit the source to fit your 
requirements. The source is supplied for CPYFST3F.COM and I 
list all the differences for CPYFST3M.COM and CPYFST3S.COM 
later in this file. 


To run, just type: CPYFST3n<cr>. The program will then 
request the source and destination disks, (drives A - F) and 
give you a chance to put in the correct disks in the drives 
before continuing (or quit by entering CTRL-C). When done, 
the program will ask if another pair of disks is to be 
copied, and the process repeated. 


The range of tracks copied can also be specified ina 
single character parameter after the program name. That is: 
CPYFST3n X<cr> where X is one of the following values: 


°e A All 0-76 Entire disk 
D Data 2-76 CP/M data area 
F First 2 CP/M directory track 
L Last 76 Last track on disk 
fe) One 1 Track one, UCSD directory 
P Pascal 1-76 UCSD Pascal data area 
s System 0-1 CP/M bootstrap 
Z Zero 0 Track zero, UCSD bootstrap 


(Note: only complete tracks are copied) 


Only the first character is checked, so the full word may 
be spelled out, if desired. Invalid letters will cause an 
error message, and the program will not run. The default 
range, currently 2 to 76, is given in the program at 
locations 12DH and 12EH. 


The console is checked often to see if the operator has en- 
tered a CTRL-C, so it is possible to abort the program even 
during the actual copy. 


If the number of buffers specified during the assembly is 
too large, that is, if the CBIOS would be overlaid during 
the copy, then a message will be issued and the program will 
reduce the number of buffers to fit the system. 


This source can be assembled with the CP/M ASM or MAC. 


3 COPYFAST runs on an 8080 or Similar CPU, CP/M 1.3, 1.4 or 
| 2.2, or Cromemco CDOS disk operating systems as_ supplied, 
and does not use any particular type of controller or disk 53 
hardware, other than the "standard" 77 track, 26 sector-per- cer es 
track disk. The latter two numbers can be easily chanaed in 


the source. 


The program currently assumes that the disk controller can 
read and write the disk in just one revolution. This means 
that an entire track can be written and checked in two 
revolutions. Two alternate interleave tables are included 
in the source if this is not possible with your hardware, 
and any sector interleave can be used by changing the table. 
An assembly option is available to allow interleaved reads, 
if your disk controller cannot keep up with the program. An- 
other option is available if read interleaving is not used, 
to increase the read speed by changing the first sector read 
on each track so the read will start as soon as possible af- 
ter the seek is complete. 


This program has been run unaltered on.a Micromation 
Doubler disk controller with Shugart drives, the Califor- 
nia Computer Systems model 2422A disk controller, a Tarbell 
single density controller board, and a Cromemco 4FDC board 
(the latter two use a WD 1771 chip) with Persci drives, and 
the worst copy time was 122 seconds. A typical time is more 
like 56 seconds (CCS controller). Faster hardware means 
faster copies. 


The program is written with all necessary constants in eq- 
ates, so modifying it for some other type of sector size, 
for example, should be fairly easy. In fact, Roy Lipscomb, 
a member of the Chicago Area Computer Hobbyist Exchange, 
wrote a program called FOTOCOPY for the fThinkertoys DJ2D 
controller after asking me a few questions about the purpose 
of the BIOS calls. I believe he simply modified the CBIOS 
jump table in the program to point to the on-board EPROM of 
the DJ2D, and changed the various equates to what was 
necessary for a 512 byte double-density disk. He reports 
really fantastic copy speeds for that controller using my 
methods. 


The only bad comments I have heard to date is that the pro- 
gram isnt fast with the Txxxxxl and Txxxxxxxxy versions of 
CP/M. The two cases I got personally involved with turned 
out to be very much the same thing: poorly written sector 
blocking/deblocking routines. In one case, I suggested that 
the interleave table be changed to 1,2,3,4,9,10,11,12,... 
in a 512 byte (128*4) sector. That way, the first four 
"sectors" fit into the first physical sector, and then the 
four "sectors" in the third physical sector are done, and so 
on. The second case turned out to be a bug in the DEBLOCK 
code that Digital Research is suggesting be used in CP/M 
2.X- The source they are distributing will miss blocks 
and/or cause unnecessary I/O to the disk. If you use their 
code, do so with care. 


One manufacturer of controller boards is supposed to be 
supplying a CBIOS that checks the density of the disk on 
every single track. Obviously, that will really slow down 
everything, including COPYFAST. 


Note: for CP/M 2.x users with single drive systems and sec- 
tor sizes greater than 128, the program now homes the disk 
before swapping the disk (at label STARTL). This is to give 
‘the CBIOS a chance to write the last sector. If homeing the 
drive is not enough to cause your CBIOS to empty the buffer, 
then add any code at that point that will do so or change 
the CBIOS. I recommend the latter, since homing the drive 


is only done in such special cases such as a reboot or a 
eb nr iseeran 


epree 4 


Quick course in floppy disk functions: 


The IBM 3741 floppy disk has 77 tracks, or positions where 
the read/write head can be. There is always a counter some- 
where in the BIOS and/or disk controller board that gives 
the current position of the currently selected disk. It 
usually takes about 15ms to move the head one track (in or 
out), and can take up to 120ms to move the heads from track 
76 to track 0. Track zero, by the way, is at the outside 
edge of the disk. The diskette rotates at 360 RPM, or 167ms 
per revolution. The standard format specifies that there 
are 26 128-byte sectors, or records, on each track. 


A little quick arithmetic will give you the results that it 
takes maybe 6ms or slightly longer for one sector to pass 
under the head. Since the disks are always rotating, there 
is always some sector now under, or about to be under, the 
head. It can also take an entire sector for a floppy disk 
controller to find where it is, assuming that the disk head 
was suddenly and randomly loaded, or moved to another track. 
Furthermore, many floppy disk controllers cannot even read 
one sector after another, or perhaps they can read, but 
cannot write that fast (since writing requires that some of 
the gap bytes be written before and after the data, where 
reading can start just after the address mark, and stops 
when the first gap byte after the data stops.) 


Another major consideration for copy programs is that it 
takes maybe 30ms for the head of a disk drive to be loaded 
onto the surface of the diskette, and you dont like to do 
that often, since the impact could cause wear. 


What does this all mean? Well, suppose you want to write a 
copy program. First, you have to tell the controller what 
track to start at, and to load the head. That might take 
30ms to load the head and 50ms to move the head to the right 
track. Now, you want to read sector one, but sector one is 
not there right now. You might have to wait 80ms for sector 
one to come around. (there is no CBIOS command for "read 
the next sector, whatever that is" and some controllers 
cannot do it at all) After you have read sector one, maybe 
you then want to read sector two. Unfortunately, you waited 
too long to decide, and the head is now halfway through 
sector two. So, the controller waits 166ms for the start of 
sector two to come sround again. You would have been better 
off if you asked for the odd sectors first (1,3,5...) and 
then gotten the even sectors on the next revolution. That 
would take only 334ms all in all. That is what is called 
read interleaving, or skewing for short. 


There is another type of skewing, called track skewing. 
That occurs when you have read the last sector, sector 26 
for example. Now, you order the disk to move the head to 
the next track. That took 15ms, and in that time sectors l, 
2, and part of 3 rotated by under the head. So, if you tell 
the controller to read sector 1, then you have to wait until 
sector 1 rotates by again, about 150ms. If you could start 
this read at sector 4, and read everyting sfter that, you 
would not waste aS much _ time. That's track (or seek) 
skewing. 


In order to make a copy in the shortest time, this program 
Anes all af the fal nings 


cerest S 


1. Reads aS many tracks as possible into core, and then 


2. Does 


3. Does 


switches to the other drive to write. This will 
minimize the number of times the head on each 
drive has to be loaded. 

all reads as fast as possible, with any skew that 
is needed to achieve that. The fastest possible is 
no skewing at all, of course. The skewing pattern 
is in a table for easy manipulation. 

all writes as fast as possible, with any skew that 
is needed. The write skew does not have to be the 
same as the read skew, because some controllers can 
read faster than they can write. 


4. Allows track skewing on the main read so that the track 


can be read with as little rotational delay as poss- 
ible. The read after the write does not need this 
skewing, because there iS no movement between the 
write and the following read. 


The program does one thing that slows it down: it checks 
the data that is written by reading it back. If you are very 
confident of the reliability of your system, controller, 
and disks you could skip that step. I think that starts at 
label WT3 in the program, and the code could be commented 


out. On 
onds to 


SINGLE: 


 ) RSKEW: 


TRSKW: 


DOCOMP: 


WRSWCH: 


@ vomerr: 


a normal controller, that step adds about 12 sec- 
the copy time, and I think it is worth it. 


Assembly-time variables that can be changed: 
TRUE for single drive copy program 


TRUE if read interleaving needed. If FALSE, the 
program will read the sectors sequentially (1,2,3, 
4peee) When TRUE, you should modify the read skew 
table (READTAB) to fit your particular requirements. 
Read skewing is used on the initial read and on the 
read-after-write check. (This is FALSE for CPYFST3F 
and CPYFST3M and TRUE for CPYFST3S.) 


TRUE if track to track read skewing is desired when 
there is no read skewing. TRSKW may be TRUE only 
when RSKEW is FALSE. TSKEW gives’ the value of the 
track sector skew. (This is TRUE for CPYFST3F and 
CPYFST3M and FALSE for CPYFST3S.) 


TRUE if byte-by-byte comparison is desired on 
read-after-write check. 


TRUE if it is necessary to pass your CBIOS different 
values in reg. C during writes. See the CP/M 2.2 Al- 
teration Guide for the purpose of this value in req. 
C. If TRUE, it will be necessary to edit the WRTAB 
table to fit your particular requirements. If FALSE, 
the value in reg. C will be that given in WRCODE, 
normally 2. 


The number of errors before counting as a permanent 
error. The error counter applies independently to 
each track read, but applies to each entire write 
pass. That is, the program will try to read each 
track NUMERR times, and will quit and then go to the 
next track. However, when writing, the program will 
stop writing when NUMERR errors have occurred on the 
current pass, and then it will start anew 


cpy ri b 


read/write pass at the track after the track with 
the write error. The read and write error counters 
are independent, since they are supposed to be two 
different disks. 


SDLAST: the number of sectors per track. This value also de- 
termines the size of the READTAB, WRITAB, and WRTAB 


+] tables. 


TSKEW: The value of the track to track read skew. This 
applies only if RSKEW is FALSE, that is, no read 
sector skewing. This is to allow even faster 
reads when a fast disk controller chip is used. The 
reason is this: after the last sector on the track 
is read (usually 26), the program must move the arm 
on the disk to the next track. This takes time, of 
course, and so the disk has rotated a bit. So, if 
the next sector wanted is the first, then the 
program has to wait until the disk has rotated a- 
round all the way back to the start. But if the 
program could then start with sector 8, say, there 
would be no waiting. Of course, the program would 
have to read sectors 1-7 after reading number 26, 
and then move the arm. So, then it should start 
reading the next track at sector 13, and so on. In 
this case, the value of TSKEW is 7. The program 
will always start a pass on sector one, but will 
not start at sector one if the track skew gives a 
value greater than SDLAST. That is, track skewing 
is a modulus function. If TSKEW is 7, the poss- 
ible starting sectors are 1,8,15,22,3,10,17,... if 
SDLAST is 26. Track skewing is used only during the 

oO initial read from the source disk. On the 
read-after-write check, the write skew table is used 
to compensate for the head load and seek times. This 
value is ignored if TRSKW is FALSE. 


SECSIZ: number of bytes per sector. Read the comments re- 
garding the sector size below if you plan to adapt 
the program to some other type of disk format. For 
CP/M compatible BIOS routines, this is always 128. 


WRCODE: If WRSWCH is FALSE, this is the value passed to the 
CBIOS sector write routine in reg. C. See the CP/M 
2.2 Alteration Guide for details of this value, but 
it is normally 2 for this application. 


FIRSTRK:the first track copied. If the starting track for 
the source and object disks are not identical, then 
this figure applies to the object disk. Note: this 
value is normally the track where CP/M places the 
directory. It is assumed that the bootstrap starts 
at track 0 and ends on track FIRSTRK-1. 


LASTRK: the last track copied plus one. The number of tracks 
copied is normally LASTRK-FIRSTRK. 


These latter two values specify the copy range, and 

re] the program can be run in other ways’ by the param- 
eter given when COPYFAST is first invoked. FIRSTRK 
and LASTRK specify how the parameter will actually 
be interpreted. 


All 0-(Lastrk-1) Entire disk 
Data Firstrk-(Lastrk-1) CP/M data area 
First Firstrk CP/M directoryv track 


cpy est) 


Last (Lastrk-1) Last track on disk 


One A. Track one, UCSD directory 
Pascal 1-(Lastrk-1) UCSD Pascal data area 
System 0-(Firstrk-1) CP/M bootstrap 

Zero 0 Track zero, UCSD bootstrap 


(Note: only complete tracks are copied) 


+] BUFFNU: the number of full track buffers that will fit into 
your system. This figure includes the space used by 
the read-back buffers, if used. Zero or minimum 2. 


If you wish auto~size determination, set BUFFNU to 
zero, and the program will use all space up to, but 
not including the CBIOS routines. With the current 
specification of 26 sectors per track, the program 
will require at least 39K for buffers alone if 
BUFFNU is 12, and so should run in a 42K = system 
minimum. (12 * #4128 * 26 = 39936 plus 3K for the 
CBIOS and program). I recommend that BUFFNU be 
minimum of 2 if you do not want auto-size 
determination. 


DIFFTRK: is the difference between the source and the object 
track numbers. That is, this quantity is added to 
the object track number to. get the source track 
number. This is so that the program can move tracks 
around from one disk to another. This is normally 
Zero. DIFFTRK is ignored in a single-disk program. 


For example, to copy tracks 25 to 49 from a UCSD 

Pascal disk to tracks 0 to 24 of an empty disk, set 

FIRSTRK to zero, LASTRK to 25 (24 plus 1), and then 
) DIFFTRK has to be 25(source) - O(object), or 25. 


DIFFTRK is used only when the default copy range is 
used. If one of the range parameters is specified, 
then DIFFTRK will be set to zero automatically. 


The last four quantities are in single-byte constants in 
the program, and can be modified by DDT to alter the charac~ 
teristics of the program to suit your needs. They are found 
at label TRKSRT in the program, at locations : 


FIRSTRK 12D 
LASTRK 12E 
BUFFNU 12F 
DIFF TRK 130 


I change these values to create various versions of Copy 
programs. These values are defaults, and they are not used 
if the range parameter is specified, (or in the case of 
BUFFNU, if CP/M is too small). 


Note: some distributors of CP/M (such as Micromation), 
supply a CBIOS that alters the BDOS routines, whether or not 
the BDOS is present there. This means that you cannot 
safely let COPYFAST take all space up to the CBIOS, because 
the CBIOS will modify the contents in the highest buffer in 
the mistaken idea that the BDOS is’ there. This usually 

Ce] means that the CBIOS cannot be used for UCSD Pascal, either. 


Note: if you are modifying this program for use with other 

than 128 byte sectors, and this has been done successfully, 

you MUST change the code at labels RT3, WT3, and WT4. The a 
change generally consists of adding a few more DAD H_ lines eff FS 
to the code. There 3re currently 7 of these since 1378 = 2? 


to the 7th power. If you are going to be processing 1024 
byte physical sectors, then add 3 more DAD H instruction to 
each of the three places indicated, because 1024 = 2 ~ 10. 
Do not change the number if you are running with a CBIOS 
written to deblock the physical sectors into 128 byte 
logical sectors, as all CP/M 1.x and 2.x compatible BIOS 
routines do. In such cases, the number of "sectors" per 
track is changed instead, exactly the same as CP/M itself is 
told. The CBIOS in that case will put the logical sectors 
into one physical sector before doing the write. It will of 
course be necessary to change the sector skew tables’ to 
something that matches the capabilities of the disk 
controller and the blocksize. You must understand exactly 
how your CBIOS blocks and deblocks from the physical sectors 
before you can make up a good skew table. 


Alternate interleave table for slower controllers. 


The sectors are listed in the order they will be written to 
Gdisk. NOTE: the peculiar ordering is due to the fact that 
some disk controllers cannot switch between writing sector 
26 and reading sector 1 in time - so the table begins with 
25, proceed up every other sector, and ends with number 24. 
While the head is passing sectors 25 and 26, the program 
will be switching to read back the entire track. There is 
generally no problem starting with sector 25, because simply 
moving the head after the previous read on most drives will 
take about one half revolution. This table was determined 
empirically using Shugart drives and doing actual tests with 
two different types of controller boards, and it is the 
fastest variation found. Change at your own risk. 


DB 25,1,3,5,7,9,11,13,15,17,19,21,23 
DB 26,2,4,6,8,10,12,14,16,18,20,22,24 


(This table is used in CPYFST3M.COM and CPYFST3S.COM) 


The following table is recommended for those whose 
controllers cannot write even every other sector. There is 
no peculiar starting sector here because the interleave ends 
on sector 24, and that is the same as the table above. This 
might be a better choice for a "universal" table. 


DB 1,4,7,10,13,16,19,22,25 
DB 2,5,8,11,14,17,20,23,26 
DB 3,6,9,12,15,18,21,24 


It is likely that if you require one of the alternate write 
skew tables, then you will also have to have read skew. So, 
you should also make RSKEW equal to TRUE and modify the read 
skew table to run as fast as possible. 


ee ee tee ee at Ne Ye Saye A Sr A es ey Me se ee Se tne ee me fe et ee ee ee se 


Users of double-density controllers may be interested in 
what I did with mine. My BIOS is written so that a double 
density disk is considered as two single disks, that I refer 
to as "the front half" and "the back half". With three 
drives, A, B, and C are the fronts, and D, E, and F are the 
back. A single density disk is only front. Each track has 
3328 bytes (26*128) bytes of data for the front half, and 
3328 bytes for the back half. The way COPYFAST works makes 
it possible to copy the front half to the back, and 
vice-versa and Tt dont have ~2a tat of funnv versions of 


programs written exclusively for a particular density disk. 
Two "disks" per floppy also means twice the directory space. 
My BIOS is also written to check the disk density whenever 
the disk in HOMEd, which COPYFAST does before starting. The 
only hardware dependencies in my system are in the disk 
initialization program and in the BIOS. 


Suggestions for improvements: 


1. Ask if you really wanted to copy a disk if track 2 
(the directory) was completely empty i.e. all E5's 

2. Better error checking .. the program reports only 
one comparison error per track right now. 

3. Have an option where it only compares two disks to 
see if they are the same. 

4, Check for CP/M 2. If so, use the disk attribute table 
for information like number of sectors, number of 
tracks, etc. 

5. Could this thing be modified for hard disk backups? 


O> 
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TYPE READMY.PJS 
PJS Co 
993 S. Santa Fe, "C" 
Vista, Ca. 92083 
(619) 727-1015 


ABOUT OUR RENTAL LIBRARYS 


Many people would like to have a software library tailored 
to their particular interests, but purchase of such software at 
todays outrageous prices is mostly prohibitative. 


However, there are alternatives for the astute. US and; 
PUBLIC DOMAIN SOFTWARE 


Through the efforts of LOTS of unselfish people, many volumes 
of very useful software have been collected. There are hundreds 
of interesting programs here which you may copy and use without 
payment of license or royalty fees of any kind to anybody. These 
programs were placed in the "Public Domain", either by kind 
individuals who donated them for the common good of computerists 
like ourselves, or were simply judged by the owners to be ‘unco 
pyrightable' for a variety of reasons. Some were just donated 
when they were outmoded in the market-place. Regardless, with the 
source code, it's a great start for your own modifications and 
ideas. Suffice to say that you may use these programs, modify 
them, copy them, give them away-whatever you wish, they are in 
the 'Public Domain'. Enjoy yourself. 


A kind word should be said about the "UG" (Users Group" and 
"SIG" (Special Interest Group). These are (like) clubs who have 
assumed the task of co-ordinating and collating this material 
into the form you now see it. These groups should be supported as 
much as possible by contributing (use the submission form found 
on most of the volumes) your software routines and programs and 
upgrades of these programs to them for dissemination. The main 
reason we came to be aS a company is because they are not a 
business and the complaints they get for slowness in filling 
orders for disks and so forth is due in a large part because of 
their efforts in producing the PD disks. Anyway lets give them a 
hearty "THANKS" for making this all possible. 


RENTING... 

Now, about our rental arrangement- we send you the complete’ 
CPM or SIG/M software (or whatever) library-complete to the 
latest available issue for your use for 7 consecutive days after 
your receipt. On the 8th day you are expected to return the 
library, by the best means available to you. You have 3 days 
grace to return it (maybe a little more). Otherwise we will 
charge your credit card account $5.00 a day for each day you're 
late up to the value of the library, which for insurance purposes 
is put at $6.00 per disk. Yes, you can buy the library! Just 
don't return it! If you need another week let us know, we just 
charge the regular rental. 


ONLY CREDIT CARD CHARGES... 
We only deal with credit card holders, because it's felt 
they are certainly reliable and we can charge their card if late 
or a problem with returning the disks, but if you don't have a 
card-no problem, give someone you know who has a card the cash 
and let them order the library for you! (we take M/C,Visa & AMEX) es { 


We An not normally charge vour card until we shin the libra 


ry to you (except for American Express, due to the delay in 
processing) and to save you C.0O.D charges, we put the shipping on 
your card and a handling charge (costs to take it down to ship, 
y'know), which we've flat rated at $7.50 per library,(this en 
cludes the insurance of $300 per library). We won't charge you 
for overtime unless your shipping date shows a tardiness in 
returning the library. Give us and those on the waiting list a 
break and return it on time, or if finished sooner, send it back 
early! 


RETURNING THE RENTAL LIBRARY. 

Shipping alternatives: the all-around best way seems to _ be 
United Parcel Service (UPS). 5 working days will move a_ parcel 
completely across the country, less for shorter distances. UPS 
"Blue Label" will move it by air in 3 days at a very nominal 
charge. "Priority Mail," or "Parcel Post" must not be used as 
they deliver the mail when they get around to it, which may cost 
you $5.00 a day.!! Whatever you use, charges must be paid by you 
and be sure to insure for the $6.00 per disk value. Express mail 
is O.K. too. Computer Shopper has run some excellent info about 
shipping in the March and April 83 issues. Everyone should be as 
well informed. (Computer Shopper is also running a_ colume 
dedicated to public domain software, as well.) 


HOW TO USE THE SOFTWARE LIBRARY 
Those familiar with the CPM-UG and SIG/M will have somewhat 
of an advantage over those who are seeing it for the first time 
because the first-time user will be simply overwhelmed by the 
volume of material presented. Be aware that theres a lot of chaff 
that has to be waded though before the kernels are found, but be 
also aware, one mans chaff is anothers kernel, and VV. 


You should use your printer to run out a catalog of what 
you've got, as that will be very useful later should you find you 
need something you failed to copy. You may run each disk 
individually of the CPM-UG to print out the 'Catalog.xxx' while 
for SIG/M the UG has thoughtfully provided a catalog disk for all 
the library programs on #55 (SIG/M LOG). After surveying those of 
interest, read the word files on the disks for more info, 
READ.ME, DOC, etc. Look for the latest version of a pgm, but note 
that an earlier one may have features of more value to you. We 
now provide you with a Directory disk which has complete listings 
ofthe software on it. You may print it out on your printer for a 
hard-copy, or use your crt to peruse it. The 'find' program is 
very usefull in pinpointing areas of interest by using key words 
(FIND CPMUG.DIR MODEM) would give you a listing of all the disks 
with references to modems. Some folks charge as much as $20.00 
for such a printed listing, you've saved that already! 


Save more money with this tip! 

As you recognize the value of some of these programs, such 
as Osborne Accounting, Businessmaster, Pascal, the various ver 
sions of Adventure and other interesting games, you will run 
short on disks. Many people know that the manufacturer of disket 
tes do not make a variety of quality disks. They make a basic one, 
then if the customer wants to copy both sides for instance, the 
QC people format the back side of the disk for him, and if it 
passes QC, charge more money for it. Knowing this, some folks 
have made a good business selling a 'kit' to let you use the back 
side of your disk, either singlesided or doublesided, by punching 
the appropriate hole for the light sensor within the drive to 
shine through, thereby identifying it to the drive as to what it 
is. You can do this yourself with a little hand stationary store 
paper punch. Never mind that the hole may be a little smaller, 
you just have to be a little more accurate. Mark the new hole on 
both sides of the disk then carefully lift u»>» the disk cove’ and 


esse 


punch out the hole. Do this for the back side, too. If you 
punched the hole to the left of the existing hole in your SSSD 
8" diskette, it may now be used as a 'Flippy', thereby doubling 
it's storage capacity. If you punch the hole to the right, you 
can use it doublesided, IF YOU TAPE OVER THE OLD HOLE! Use an old 
disk with the media removed as a pattern to mark your holes. 
Should you not want to bother with this simple procedure, we sell 
'flippys' for $3.00 each (only with a library order.) 


MISSING DISKS???? 

Some folks may be missing some disks. Don't get excited. In 
the CPM/UG Library Vol 55-78 are copys of the SIG/M Libary! The 
CPM/UG did this for reasons unknown, (and we understand thoughly 
P-O'd the SIG/M UG). If you ordered the CPM library alone you 
should have these disks, if not let us know. If you ordered both 
Librarys, You have these disks under SIG/M. Please let us know if 
any disks are blank or 'glitched' so we can keep our librarys in 
good shape. Use the form provided or leave us a txt file and call 
it'feedback' with your initials. 


QUALITY.... 

We make these copys 'track-for-track' and haven't had any 
problems, but should you find a glitched disk or some other 
problem, let us know with a note and send a blank, formatted disk 
back when you return your library and we'll copy a good copy onto 
your disk and mail it to you. NOTE-we don't say these programs 
run! Just that you get a good copy. 


IMPORTANT! 

This disk is to be used for comments to us and others, 
please use it for that and let us know what you think about this 
rental program and your benefits from it. Lots of kind people 
want to share some of their favorite utilitys, etc. for which 
we're grateful, but be sure never, never write any copyrightable 
Material to any of our rental disks which might fall into the 
hands of any of the wealthy 'programmers' responsible for the high 
prices of commercial software, as they would love to 'make an 
eee. of us with an expensive lawsuit we couldn't afford to 

efend. 


In addition....... 
We rent Demo Programs! 


Yes, now you can rent a demo disk and program for most any 
available program for just $25.00! (plus shipping) Keep it for 7 
days while you evaluate it and study the manual. Should you 
decide to buy the full pgm, we will quote the lowest price 
available anywhere! 


Don't want to invest $25.00? Then rent just the manual! Yes, 

we'll send you a manual to read and study for 7 days on any 
commercially avaialble software program for just $10.00 (plus 
shipping) He's your chance to evaluate that interesting program 
you've heard about or seen without spending more than you can 
afford. We don't ask you to refrain from copying these manuals, 
but we should, as the publisher probably wouldn't like it. 
Give us a chance to quote on any of your software and hardware 
requirements. We don't have the overhead that the biggies have, 
as we deal by mail only, working mostly weekends, (our address is 
mailings only),so maybe can save you money. 


AND LASTLY, 


Keep your library up to date! Join our subscription service 
and automatically receive the latest volumes as they are released 
from the users grow ods on our 'fli.s>.° Adisks! two volumes er 
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disk. We charge your card (with your authorization) when we ship 
the disk for $7.50 including postage. Join Now! 


Happy Computing! 
9 14 Aug 83 
PJ 


-pa 


O>TYPE TOMAREK.PJS 
The Mareks 

4563 Albury ave 
Lakewood, Ca. 90713 


Gentlemen, 

Thanks for your kind assessment of the disks you received 
from us last week. We really appreciate your comments as it is 
in this manner that we get the input to correct any defieciencys 
in the disks, as it would be too time consuming for us to re- 
evaluate each library as it it is returned to us. 


The specific problems you encountered are evidently a result 
of "glitches" produced by our patrons poor handling procedures, 
except for SIGM 048, where our master seems to be "glitched". 


As per our guarantee, we have re-run the ones youve pointed 
out were defective, (except for 048) and hope you will have no 
problems with them. If you do, send along another blank, formatted 
diskette and we will run another copy for you. 048 will have to 
wait for now, but we will make it good, for sure. 

Thank you again for your help. 

Paul Jones 


P.J.'s Co. 
O> 
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POLY-VU 
#PVI19 


K&M Company 


Fe} TORRANCE, CA 90303 
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Pp. CPMUG vol. 
-CATALOGOO] — 3K 
ASSIGN ASM 8K 
CASDSK ASM 2K 
COPY ASM 9K 
COPY COM 8K 
COPYX ASM 9K 
DIABLO ASM 4K 
DISASSM1ASM 8K 
DISASSM2ASM 4K 
DISKTESTASM 9K 
DSKCAS ASM 2K 
ED3 ASM 1K 
EXAM ASM 7K 
FILES COM 1K 
GETVEC LIB 1K 
HYS13 ASM 4K 
HYS15 ASM 5K 
ICOPY ASM 7K 
IDIR ASM 6K 
LIOS ASM 7K 
LTG ASM 10K 
MAZE ASM 6K 
More.. 

MAZE COM 3K 
MAZE HEX 3K 
MAZE PRN 13K 
MEMTST ASM 4K 
PRINT ASM 7K 
PRNT ASM 5K 
RELOC ASM 10K 
RTE ASM 7K 
SEDIT ASM 4k 
SPACE ASM 16K 
SPAT ASM 8k 
TRAIN ASM 3K 
TREAD ASM 4K 
VBIOS31 ASM 17K 
VBOOT31 ASM 3K 
VOLUME] DOC 3K 
XDIR COM 2K 
XSTAT COM 1K 
40 file(s). 


23 directory entries remaining. 
D>STAT O: 


Bytes Remaining On O: 7k 


D> 


i 


5/18/86 


1.14 


: =<CATALOC. 


1K 


10K 


10K 


16K 


17K 


Ae —_VOLUME_1_. 
NAME 


CATALOG.1 
VOLUME1.DOC 


ASSIGN.ASM 
CASDSK.ASM 
COPY.ASM 


COPY.COM 
COPYX.ASM 


DIABLO.ASM 
DISASSM1.ASM 


DISASSM2.ASM 
DISKTEST.ASM 


DSKCAS.ASM 
ED3.ASM 
EXAM.ASM 


FILES.COM 


GETVEC.LIB 


HYS13.ASM 
HYS15.ASM 
ICOPY.ASM 


IDIR.COM 
LIOS.ASM 


LTG.ASM 
MAZE.ASM 
MEMTEST.ASM 
PRINT.ASM 


PRNT.ASM 


RELOC.ASM 
RTE.ASM 

SEDIT.ASM 
SPACE.ASM 
SPAT .ASM 


TRAIN. ASM 
TREAD.ASM 
VBIOS31.ASM 
VBOOT31 


XSTAT.COM 


VARIOUS CP/M UTILITY. PROGRAMS 
COMMENTS 


CONTENTS OF CP/M GROUP VOL 1 
COMMENTS ON CERTAIN PROGRAMS ON 
VOLUME 

IOBYTE ASIGN. USE WITH VBIOS31 
CASSETTE TO DISK TRANSFER 

COPY SYSTEM, DATA OR WHOLE DISKETTE 
FROM DRIVE A TO B. 

AS ASM, USED TO COPY THIS DISK 

AS COPY, USES INTERNAL SCRATCH 
INSTEAD OF AREA AT 40H 

ROMABLE HYTYPE/QUME DRIVER 
CHRISTENSEN DISASSEMBLER AS PER 

DR. DOBB'S OF FEB 1977. SEE 

ALSO SEDIT.ASM BELOW 

INTEL LIBRARY DISASSEMBLER 

PROGRAM TO SEARCH FOR SOFT AND 

HARD SECTOR ERRORS IN DISK I/0 
DESTROYS FILES ON DISKETTE AND 

ONLY RUNS IN 16K SYSTEMS 

DISKETTE TO CASETTE TRANSFER 
PATCHES FOR 'R' BUG IN CP/M ED.COM 
SECTOR VIEWER FOR VDM. SEE 
DISK1.DOC 

GIVES CONSOLE DISPLAY OF DIRECTORY 
RECORD NUMBERS ASSIGNED TO EACH 
FILE. OFFERS TO DELETE FAULTY 
DIRECTORY ENTRIES. 

ASM ROUTINE TO CREATE BIOS PRIMITIVE 
JUMP TABLE. BIG IMPROVEMENT ON ARG'S 
IN COPY. TOM KIRK SAYS A Z80 CAN 
DO IT ALL IN 4 INSTRUCTIONS!! 
DIABLO DRIVER FOR 3P+S IN Z80 
DIABLO DRIVER FOR 3P+S IN 8080 

COPY A FILE FROM ISIS DISKETTE 

ON B TO CP/M DISKETTE ON A. USE 
IDIR FIRST TO IDENTIFY FILENAMES 
LISTS TO CONSOLE DIRECTORY 

OF ISIS DISKETTE IN B. 
CP/M I/O SUBROUTINES. 
FOR APPLICATION 


SEE PRINT 


INTEL MAZE PROGRAM 

INTEL RAM TEST 

MOD OF PRNT TO PERMIT CONDITIONAL 
ASSEMBLY FOR CON:/LST: AND FOR 
HARDWARE FF OR NONE 

TRANSIENT TO PRINT FILES WITH 
PAGINATION AND PAGE NUMBERS 

CP/M RELOCATION PROGRAM 

INTEL REAL-TIME EXECUTIVE 

SYMBOL TABLE EDITOR OF DISASSM1 
GAME 

RE-WRITE OF EXAM TO ALLOW WRITING. 
SEE VOL 3 FORMAT.BAS AND README.FMI 
VDM GRAPHIC 

TAPE READER TO DISK TRANSFER 

BIOS FOR 32K OF MEMORY WITH VDM 
COLD BOOT FOR VBI0S31 

SIMILAR TO STAT. REPORTS # OF 
FILES AND NULL FILES. KNOWN BUG 
IS THAT IS REPORTS NULL EXTENTS 
TO NON-NULL FILES. DON'T DELETE 

A FILE BASED ON THISI!!!! 


TYPE O:VOLUME1.DOC 


PRNT 


EXAM 


MEMTST 


ASSIGN 


MAZE 


TRAIN 


VBIOS31 


- IS A PRINT UTILITY SOMETHING LIKE TYPE BUT 
WITH PAGINATION AND HEADINGS. IT SHOULD RUN ON 
ANY CONFIGURATION OF CP/M WITH AN I/O DEVICE 
THAT RECOGNIZES A FORM FEED CHARACTER (HEX OC) 
AS A TOP-OF PAGE COMMAND. THE SYNTAX FOR USING 
PRNT IS: 


PRNT FILENAME.EXT 


PRNT ALSO MAY BE USEFUL TO THOSE WHO NEED AN 
EXAMPLE OF CP/M DISK I/O ACCESS. 


~ IS A PATCHED VERSION BY ARG TO COPE WITH HARDWARE 
THAT DOES NOT RECOGNISE OCH 


- IS A PAPER-TAPE TO DISK UTILITY WHICH WILL 
ONLY WORK WITH A TELETYPE HAVING AN AUTOMATIC 
READER. THE TAPES TO BE READ MUST CONTAIN 

CR, LF SEQUENCES PERIODICALLY. THE TAPE MAY 
BE ENDED WITH A CONTROL Z. SYNTAX FOR USING 
THIS PROGRAM IS: 


TREAD FILENAME.EXT 


- IS A DISK SECTOR EXAMINATION UTILITY FOR A 

SYSTEM EQUIPPED WITH A VDM. ONCE RUNNING 

EXAM WILL ALLOW VISUAL EXAMINATION OF ANY SECTOR ON 
THE DISK (DRIVE 0 ONLY IN THIS VERSION). 

THE CURRENT VERSION WILL ONLY OPERATE IN A 16K 
SYSTEM BUT THAT IS EASILY FIXED. THE COMMANDS 

TO EXAM ARE: 


+ = READ NEXT SECTOR 

= = READ PREVIOUS SECTOR 

| iad STEP HEAD IN (TOWARD TRACK 76) AND READ 
QO = STEP HEAD OUT (TOWARD TRACK 0) AND READ 


DUE TO A MINOR BUG WHICH I HAVEN'T HAD THE TIME TO 
FIX, THE FIRST COMMAND TO EXAM SHOULD BE A +. 


- IS A MEMORY TEST FROM THE INTEL 

USERS LIBRARY. IT HAS INTERNAL I/O ROUTINES 

AND MUST BE MODIFIED TO SUIT THE USERS SYSTEM. 
IT IS A VERY GOOD TEST OF MEMORY WHICH WE 

HAVE BEEN USING EXTENSIVELY IN THE LONG ISLAND CLUB. 
THE PROGRAM WILL DISPLAY MEMTST 1.0 AT WHICH 
POINT THE USER SHOULD ENTER STARTING AND 

ENDING HEX ADDRESSES SEPERATED BY A COMMA. 

THE PROGRAM WILL THEN TYPE ADDR: REF: ACT: 

AND BEGIN TESTING. ANY ERRORS WILL CAUSE 

AN ADDRESS ,REFERENCE DATA, AND ACTUAL DATA 

TO BE PRINTED. 


- IS THE DEVICE ASSIGNMENT UTILITY TO BE USED 


WITH THE VBIOS SUPPLIED. IT SHOULD BE ASSEMBLED TO 
OBTAIN THE DOCUMENTATION. 


- IS A MAZE PROGRAM FROM THE INTEL USERS LIBRARY. 
IT SHOULD RUN ON ANY SYSTEM. 


- IS THE VDM TRAIN PROGRAM FROM THE PROCESSOR 
TECHNOLOGY NEWSLETTER. JUST TYPE 
TRAIN. 


AND BOOT31 ARE THE TWO PIECES OF A DEVICE-SELECTABLE 
CBIOS WITH A BUILT-IN VDM DRIVER, 


ye 


IDIR 


ICOPY 


THESE TWO PIECES SHOULD BE INCORPORATED 

IN A SECOND LEVEL SYSGEN IF DESIRED. THE VDM 
DRIVER HAS SPEED CONTROL USING THE FRONT PANEL 
SWITCHES. 


-READS DIRECTORY OF ISIS (INTEL FDOS) DISKETTE 
IN DRIVE B 


-READS FILE FROM ISIS DISKETTE IN DRIVE B, AFTER 
FINDING NAME FROM USING IDIR, AND COPIES AS CP/M FILE TO A 
COMMAND: "ICOPY FILNAME.TYP" 


-SET OF SUBROUTINES TO PERFORM CP/M LOGICAL FUNCTIONS FOR 
INCORPORATION IN NEW PROGRAMS 


wr 
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POLY-vU 
#PV119 


K&M Company 


TORRANCE, CA $0503 


-~CATALOG002 
LLLBASICASM 
LLLBASICCOM 
LLLBASICDOC 
LLLFP ASM 
LLLMON ASM 
STARTREKDOC 
STARTREKTBI 
TINYBAS COM 
TINYBAS DOC 
10 file(s). 


44 directory entries remaining. 


D>STAT O: 


CPMUG vol. 2 


3K 
13K 


Bytes Remaining On O: 29k 


D>TYPE O:-CATALOG.002 


VOLUME 2 


LAWRENCE LIVERMORE BASIC AND DISK TINY BASIC 


NOTE THAT IMPROVED IMPLEMENTATIONS OF LLLBASIC AND DISK 
TINY BASIC NOW ARE PRESENT ON VOLUMES 10 AND 11 RESPECTIVELY 


NUMBER SIZE 


84K 
38K 


. 
Ne 


2K 
61K 
2K 


6K 
3K 


NNN NNN LS) 


3 
4 
5 
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NAME 


CATALOG. 2 
LLLBASIC.ASM 
LLLBASIC.COM 


LLLBASIC.DOC 
LLLFP.ASM 
LLLMON.ASM 


STARTREK.DOC 


STARTREK.TBI 
TINYBAS.COM 


TINYBAS .DOC 


COMMENTS 


CONTENTS OF CP/M VOLUME 2 
LLLBASIC INTERPRETER SOURCE 
SIMPLE PATCHED COM FOR CP/M 

(NOT ECONOMICAL, BUT INSTRUCTIVE) 
NOTES ON LLLBASIC 

FLOATING-POINT PACKAGE FOR LLLBASIC 
KLUGE MONITOR TO TEST LLL IN 
LLLBASIC.COM 

COMMENTS ON STARTREK.TBI 

TINY BASIC LOADABLE’ STARTREK 
SHERRY VERSION OF WANG PALO ALTO 
TINY BASIC, WITH DISK SAVE AND 
LOAD OF PROGRAMS FOR CP/M 

FULL INSTRUCTIONS FOR TINYBAS 


5/18/86 


42PO0 DuUUBADS.L.UUL 
LAWRENCE LIVERMORE LABORATORY BASIC INTERPRETER WAS DEVELOPED 
AT UNIVERSITY OF IDAHO (POTATO BASIC?) UNDER CONTRACT FROM 
U.C.LLL. THE SOURCE WAS PUBLISHED IN DR. DOBBS JOURNAL VOL. 2 
NUMBER 1, JANUARY 1977. THE CODE IS IN THE PUBLIC DOMAIN. 


THE SOURCE IS IN 2 PARTS, THE MAIN INTERPRETER AND THE FLOATNG- 
POINT PACKAGE. IT WAS DESIGNED TO OPERATE IN 5K OF ROM. 


UNFORTUNATELY THE LINKAGE TO THE JUMP TABLE AT THE END OF LLLFP 
IS MADE FROM ABSOLUTE CODED EQU'S AT THE START OF LLLBASIC. 

IN ORDER TO RE-LOCATE THE CODE IT WILL BE NECESSARY TO RE-WRITE 
THE DOZEN-ODD ADDRESSES. PREFERABLY USE ONE EQU WITH ABSOLUTE 
ADDRESS, AND MAKE THE OTHERS RELATIVE. 


A SIMPLE MONITOR PACKAGE HAS BEEN WRITTEN, LLLMON, WHICH TAKES 
THE I/O JUMPS AND DIRECTS THEM THROUGH CP/M. LLLBASIC CONSISTS 
OF LLLBASIC, LLLFP AND LLLMON. BECAUSE OF THE LOCATION OF 

THE FIRST TWO, THE PROGRAM WILL ONLY RUN IN A SYSTEM GREATER 
THAN 42K. (41.5K IF YOU USE THE RELOC512!!) 


THE LLLMON IS ONLY INTENDED AS A HINT AND TO ENSURE THAT THE 
MAIN MODULES ARE WORKING CORRECTLY. THE ONLY MOD'S TO THE 
LLL CODE IS HAND-EXPANSION OF THE MACROS, AND IT WAS DONE IN 
SUCH A WAY AS TO MAKE THE CHANGES HIGHLY VISIBLE, WITH ALL 
ABANDONNED CODE REMAINING COMMENTED-OUT. 


A.R.G. 10/28/77 
D> 


Llas DOLANL RSA. vVUL 


STARTREK 


THIS IS A MODIFIED VERSION OF LYNN COCHRAN'S STARTREK (PUBLISHED IN 
THE JUNE 1976 ISSUE OF SCCS INTERFACE). IT IS CODED IN TINY BASIC 
(PALO ALTO VERSION) AND THUS TAKES LESS MEMORY (8K INSTEAD OF 12K) 

AND IS FASTER (4 SECONDS TO SET UP THE GALAXY MOST OF THE TIME, 
INSTEAD OF 10 SECONDS). IT IS A LITTLE DIFFERENT FROM LYNN'S VERSION: 


(1) COMMANDS ARE GIVEN IN WORDS INSTEAD OF NUMBERS. 


OR WARP FOR WARP ENGINE 

OR TORPEDO FOR PHOTON TORPEDO 
PHASER FOR PHASERS 

OR SHORT FOR SHORT RANGE SCAN 
OR LONG FOR LONG RANGE SCAN 
OR GALAXY FOR GALAXY MAP 


Qevenvs = 
je) 
wD 


(2) THERE IS ONE MORE COMMAND: 'REPORT' OR 'R' WHICH PRINTS OUT 
PERTINENT INFORMATION (INCLUDING DAMAGES). 


(3) DIRECTION (OR COURSE) IS GIVEN IN DEGREES (0 FOR NORTH, 90 FOR 
EAST, 180 FOR SOUTH, AND 270 FOR WEST), AND DISTANCE (OR WARPS) IS 
GIVEN IN UNITS OF SECTORS. BOTH MUST BE INTEGERS. 


(4) THE WARP ENGINE HAS BETTER CONTROLS NOW. YOU CAN MOVE PRECISLY 
TO WHERE YOU WANT TO GO, EVEN AFTER CROSSING THE QUADRANT BOUNDARY. 
IT STILL TAKES 1 STARDATE TO MAKE A MOVE, BUT FOR LONG DISTANCE MOVES 
YOU WILL BURN A DISPROPORTIONALLY LARGE AMOUNT OF ENERGY. 


(5) WHEN KLINGONS FIRE AT YOU, YOU COULD GET HURT NOW. (IN LYNN'S 
VERSION, THEY CANNOT DAMAGE YOU, AND THEY DEPLETE THEIR OWN ENERGY MORE 
THAN YOURS.) SO, DON'T TRY TO SIT THERE AND WEAR THEM OUT. 


(6) IF YOU HIT A KLINGON WITH YOUT PHOTON TORPEDO, THE KLINGON MIGHT NOT 
GET TOTALLY DESTROYED. ALSO, IF YOU HIT A STAR, IT MIGHT NOT GET 
EFFECTED AT ALL. WHEN A STAR IS DESTROYED, IT MIGHT NOVA AND THE 
RADIATION WILL HURT YOU. 


(7) ON THE POSITIVE SIDE, YOU GET MORE ENERGY (4000 UNITS) AT EACH 
DOCKING, AND YOU ARE WELL PROTECTED BY YOUR SHIIELD. YOU NEVER GET HURT 
UNLESS THE SHIELD IS DAMAGED. 


THE GALAXY CONSISTS OF 64 QUADRANTS IN AN 8 BY 8 ARRAY. EACH QUADRANT 
CONSISTS OF 64 SECTORS IN AN 8 BY 8 ARRAY. WHEN YOU MOVE YOU GIVE 

THE NUMBER OF SECTORS YOU WISH TO MOVE. THAT IS, 3 QUADRANTS WOULD 

BE 24 SECTORS (8 SECTORS X 3 QUADRANTS). 


D> 


TYPE TINYBAS.DOC 
SHERRY BROTHERS TINY BASIC VERSION 3.1 


THIS IS A COPY OF LICHEN WANG'S 'PALO ALTO TINY BASIC' WHICH HAS BEEN 
MODIFIED TO INCLUUDE MORE FUNCTIONS, AND DISK SAVE AND LOAD. 
IT SETS IT'S SIZE TO WHATEVER SIZE YOUR SYSTEM IS, SO IT DOES NOT NEED 
TO BE REASSEMBLED FOR DIFFERENT SYSTEM SIZES. 
IF YOU HAVE ANY PROBLEMS WITH IT GIVE ME A CALL OR WRITE ME AND I WILL 
SEE WHAT I CAN DO. HERE IS MY ADDRESS AND PHONE: 

BRUCE SHERRY 

1054 BLUEBELL DR. 

LIVERMORE, CA. 94550 

TEL (415) 443-9288 


THE LANGUAGE 
NUMBERS 
IN TINY BASIC, ALL NUMBERS ARE INTEGERS AND MUST BE LESS THAN 32767. 
VARIABLES 
THERE ARE 26 VARIABLES DENOTED BY LETTERS A THROUGH Z. THERE IS ALSO A 


SINGLE ARRAY @(I). THE DIMENSION OF THIS ARRAY (1I.E., THE RANGE OF 
VALUE OF THE INDEX I) IS SET AUTOMATICALLY TO MAKE USE OF ALL THE 


MEMORY SPACE THAT IS LEFT UNUSED BY THE PROGRA. (I.E., 0 THROUGH SIZE/2, 


SEE SIZE FINCTION BELOW.) 
FINCTIONS 


PRESENTLY THERE ARE 6 FUNCTIONS: 

ABS(X) GIVES THE ABSOLUTE VALUE OF X. 

RND(X) GIVES A RANDOM NUMBER BETWEEN 1 AND X (INCLUSIVE). 

SIZE GIVES THE NUMBER OF BYTES LEFT UNUSED BY THE PROGRAM. 
IT IS A TWO'S COMPLEMENT NUMBER SO IF IT IS 
NEGATIVE If IS ACTUALLY LARGER THAN 32767. 

INP(X) GIVES THE VALUE (0 TO 255) OF INPUT PORT X 

PEEK(X) GIVES THE VALUE OF MEMORY LOCATION X. TWO'S COMPLEMENT 
AGAIN. 

USR(X<,Y>) CALLS THE MACHINE LANGUAGE SUBROUTINE AT LOCATION X. 
OPTIONAL PARAMETER Y IS PASSED IN H&L. IF THERE AND THE 
VALUE OF THE FUNCTION IS RETURNED IN H&L. THE PROGRAM 
SAVES ALL REGISTERS, SO YOU DON'T HAVE TO. 


ARITHMETIC AND COMPARE OPERATORS 


/ DIVIDE. NOTE THAT SINCE WE HAVE INTEGERS ONLY, 2/3=0. 

* MULTIPLY. 

= SUBTRACT. 

+ ADD. 

> COMPARE IF GREATER THAN. 

< COMPARE IF LESS THAN. 

= COMPARE IF EQUAL TO. NOTE THAT TO CERTAIN VERSIONS OF 
BASIC "LET A=B=0" MEANS "SET BOTH A AND B TO 0". TO 
THIS VERSION OF TINY BASIC, IT MEAND "SET A TO THE 
RESULT OF COMPARING B WITH 0". 

# COMPARE IF NOT EQUAL TO. 

>= COMPARE IF GREATER THAN OR EQUAL TO. 

<= COMPARE IF LESS THAN OR EQUAL TO. 


+, -, *, AND / OPERATIONS RESULT IN A VALUE OF BETWEEN -32767 AND 
32767. (-32768 IS ALSO ALLOWED IN SOME CASES.) ALL COMPARE OPERATORS 
RESULT IN A 1] IF TRUE AND A O IF NOT TRUE. 


EXPRESSTONS 


yp 


EXPRESSIONS ARE FORMED WITH NUMBERS, VARIABLES, AND FUNCTIONS WITH 
ARITHMETIC AND COMPARE OPERATORS BETWEEN THEM. + AND - SIGNS CAN ALSO 
BE USED AT THE BEGINNING OF AN EXPRESSION. THE VALUE OF AN 

EXPRESSION IS EVALUATED FROM LEFT TO RIGHT, EXCEPT THAT * AND / ARE 
ALWAYS DONE FIRST, AND THEN + AND - , AND THEN COMPARE OPERATORS. 
PARENTHESES CAN ALSO BE USED TO ALTER THE ORDER OF EVALUATION. 


STATEMENTS 


A TINY BASIC STATEMENT CONSISTS OF A STATEMENT NUMBER BETWEEN 1 AND 

32767 FOLLOWED BY ONE OR MORE COMMANDS. COMMANDS IN THE SAME STATEMENT 
ARE SEPARATED BY A SEMI-COLON ";". "GOTO", "STOP", AND "RETURN" COMMANDS 
MUST BE THE LAST COMMAND IN ANY GIVEN STATEMENT. 


PROGRAM 


A TINY BASIC PROGRAM CONSISTS OF ONE OR MORE STATEMENTS. WHEN A DIRECT 
COMMAND "RUN" IS ISSUED, THE STATEMENT WITH THE LOWEST STATEMENT NUMBER 
IS EXECUTED FORST, THE THE ONE WITH THE NEXT LOWEST STATEMENT NUMBER, ETC. 
HOWEVER, THE "GOTO", "GOSUB", "STOP", AND "RETURN" COMMANDS CAN ALTER 
THIS NORMAL SEQUENCE. WITHIN THE STATEMENT, EXECUTION OF COMMANDS IS 
FROM LEFT TO RIGHT. THE "IF" COMMAND CAN CAUSE THE EXECUTION OF ALL THE 
COMMANDS TO ITS RIGHT IN THE SAME STATEMENT TO BE SKIPPED OVER. 


COMMANDS 


TINY BASIC COMMANDS ARE LISTED BELOW WITH EXAMPLES. REMEMBER THAT 
COMMANDS CAN BE CONCATENATED WITH SEMI-COLONS. IN ORDER TO STORE THE 
STATEMENT, YOU MUST ALSO HAVE A STATEMENT NUMBER IN FRONT OF THE 
COMMANDS. THE STATEMENT NUMBER AND THE CONCATENATION ARE NOT SHOWN 

IN THE EXAMPLES. 

REM OR REMARK COMMAND 

REM ANYTHING GOES 

THIS LINE WILL BE IGNORED BY TBI. 

LET COMMAND 

LET A=234-5*6, A=A/2, X=A-100, @(X+9) =A-1 

WILL SET THE VARIABLE A TO THE VALUE OF THE EXPRESSION 234-5*6 (I.E. 204), 
SET THE VARIABLE A (AGAIN) TO THE VALUE OF THE EXPRESSION A/2 (I.E. 102), 
SET THE VARIABLE X TO THE VALUE OF THE EXPRESSION A=100 (I.E. 2), AND 
THEN SET THE VARIABLE @(11) TO 101 (WHERE 11 IS THE VALUE OF THE 
EXPRESSION AX+9 AND 101 IS THE VALUE OF THE EXPRESSION A-1). 

LET U=A#B, V=(A>B) *X+(A<B) *Y¥ 

WILL SET THE VARIABLE U TO EITHER 1 OR 0 DEPENDING ON WHETHER A IS NOT 
BQUAL TO OR IS EQUAL TO B; AND SET THE VARIABLE V TO EITHER X, Y OR 0 
DEPENDING ON WHETHER A IS GREATER THAN, LESS THAN, OR EQUAL TO B. 
PRINT COMMAND 

PRINT 


WILL CAUSE A CARRIAGE-RETURN (CR) AND A LINE-FEED (LF) ON THE OUTPUT 
DEVICE. 


PRINT A*34+1, "ABC 123 !@#", ' CBA ' 


WILL PRINT THE VALUE OF THE EXPRESSION A*3+1 (I.E. 307), THE STRING v 


OF CHARACTERS "ABC 123 !@#" AND THE STRING" CRA ® AND THEN A 


CR-LF. NOTE THAT EITHER SINGLE OR DOUBLE QUOTES CAN BE USED TO QUOTE 
STRINGS, BUT PAIRS MUST BE MATCHED. 


PRINT A*341, "ABC 123 !@#", ' CBA ', 


WILL PRODUCE THE SAME OUTPUT AS BEFORE, EXCEPT THAT THERE IS NO CR-LF 
AFTER THE LAST ITEM IS PRINTED, THIS ENABLES THE PROGRAM TO CONTINUE 
PRINTING ON THE SAME LINE WITH ANOTHER "PRINT". 


PRINT A, B, #3, C, D, E, #10, F, G 


WILL PRINT THE VALUES OF A AND B IN 6 SPACES, THE VALUES OF C, D, AND 
E IN 3 SPACES, AND THE VALUES OF A AND G IN 10 SPACES. IF THERE ARE 
NOT ENOUGH SPACES SPECIFIED FOR A GIVEN VALUE TO BE PRINTED, THE VALUE 
WILL BE PRINTED WITH ENOUGH SPACES ANYWAY. 


PRINT 'ABC',_,'XXX' 


WILL PRINT THE STRING "ABC", A CR WITHOUT A LF, AND THEN THE STRING 
"XXX" (OVER THE ABC) FOLLOWED BY A CR-LF. 


INPUT COMMAND 
INPUT A, B 


WHEN THES COMMAND IS EXECUTED, TINY BASIC WILL PRINT "A:" AND WAIT TO 
READ IN AN EXPRESSION FROM THE INPUT DEVICE. THE VARIABLE A WILL BE 


SET TO THE VALUE OF THES EXPRESSION. THEN "B:" IS PRINTED AND VARIABLE 
B IS SET TO THE VALUE OF THE NEXT EXPRESSION READ FROM THE INPUT DEVICE. 
NOTE THAT NOT ONLY NUMBERS, BUT ALSO EXPRESSIONS CAN BE READ AS INPUT. 


INPUT 'WHAT IS THE WEIGHT'A, "AND SIZE"B 

THIS IS THE SAVE AS THE COMMAND ABOVE, EXCEPT THE PROMPT "A:" IS REPLACED 
BY "WHAT IS THE WEIGHT:" AND THE PROMPT "B:" IS REPLACED WITH "AND 
SIZE:". AGAIN, BOTH SINGLE AND DOUBLE QUOTES CAN BE USED AS LONG AS 
THEY ARE MATCHED. 

INPUT A, 'STRING',_, "ANOTHER STRING", B 

THE SRINGS AND THE "_" HAVE THE SAVE EFFECT AS IN "PRINT". 

OUT COMMAND 

OUT 2, A+5, 6, B/7 

WILL CAUSE THE LEAST SIGNIFICANT BYTE OF THE EXPRISSION "A+5" TO BE 
OUTPUT TO PORT 2, AND THEN THE LEAST SIGNIFICANT BYTE OF THE EXPRESSION 
"B/7" WILL BE OUTPUT TO PORT 6. 

OUT X+Y,Z 


THIS OUTPUTS THE VALUE OF Z (L.S. BYTE) TO THE PORT SPECIFIED BY THE 
EXPRESSION "X+¥Y¥" 


WAIT COMMAND 
WAIT I,J 


THIS READS THE STATUS OF PORT "I" AND MASKS THIS WITH "J" BY WAY OF A 
"LOGICAL AND". IT WILL CONTINUE READING UNTIL THE RESULT OF THE "AND" 
IS NOT EQUAL TO ZERO. 


WAIT I,J,K my 


6 
THIS IS THE SAME AS BEFORE EXCEPT THAT THE STATUS IS LOGICALLY EXCLUSIVE ‘ 4 
OR'ED WITH "K" BEFORE THE MASK TO INVERT BTTS TF NECCEGGARY. 


POKE COMMAND 
POKE 4000+X,Y 


THIS COMMAND WORKS JUST LIKE OUT, EXCEPT THAT EXPRESSION "Y" IS WRITTEN 
INTO MEMORY LOCATION SPECIFIED BY THE EXPRESSION "4000+x". 


IF COMMAND 

IF A<B LET X=3; PRINT 'THIS STRING’ 

WILL THES THE VALUE OF THE EXPRESSION A<B. IF IT IS NOT ZERO (I.E. IF IT 
IS TRUE), THE COMMANDS IN THE REST OF THIS STATEMENT WILL BE EXECUTED. 

IF THE VALUE OF THE EXPRESSION IS ZERO (I.E. IF IT IS NOT TRUE), THE REST 
OF THIS STATEMENT WILL BE SKIPPED OVER AND EXECUTION CONTINUES AT THE 
NEXT STATEMENT. NOTE THAT THE WORD "THEN" IS NOT USED. 

GOTO COMMAND 

GOTO 120 

WILL CAUSE THE EXECUTION TO JUMP TO STATEMENT 120. NOTE THAT "GOTO" 
COMMAND CANNOT BE FOLLOWED BY A SEMI-COLON AND OTHER COMMANDS. 

IT MUST BE ENDED WITH A CR. 

GOTO A*10+B 


WILL CAUSE THE EXECUTION TO JUMP TO A DIFFERENT STATEMENT NUMBER AS 
COMPUTED FROM THE VALUE OF THE EXPRESSION. 


GOSUB AND RETURN COMMANDS 

GOSUB 120 

WILL CAUSE THE EXECUTION TO JUMP TO STATEMENT 120. 
GOSUB A*10+B 


WILL CAUSE THE EXECUTION TO JUMP TO DIFFERENT STATEMENTS AS COMPUTED 
FROM THE VALUE OF THE EXPRESSION A*10+B. 


RETURN 


A RETURN COMMAND MUST BE THE LAST COMMAND IN A STATEMENT AND BE FOLLOWED 
BY A CR. WHEN A RETURN COMMAND IS ENCOUNTERED, IT WILL CAUSE THE EXECUTION 
TO JUMP BACK TO THE COMMAND FOLLOWING THE MOST RECENT GOSUB COMMAND. 


GOSUB CAN BE NESTED. THE DEPTH OF NESTING IS LIMITED ONLY BY THE STACK 
SPACE. 


FOR AND NEXT COMMANDS 
FOR X=At+l TO 3*B STEP C-1 


THE VARIABLE X IS SET TO THE VALUE OF THE EXPRESSION At+tl. THE VALUES OF 
THE EXPRESSIONS (NOT THE EXPRESSIONS THEMSELVES) 3*B AND C-1 ARE REM- 
BERED. THE NAME OF THE VARIABLE X, THE STATEMENT NUMBER AND THE 
POSITION OF THIS COMMAND WITHIN THE STATEMENT ARE ALSO REMEMBERED. 
EXECUTION THEN CONTINUES THE NORMAL WAY UNTIL A NEXT COMMAND IS 
ENCOUNTERED. 


THE STEP CAN BE POSITIVE, NEGATIVE OR EVEN ZERO. THE WORD STEP AND THE 
EXPRESSION FOLLOWING IT CAN BE OMITTED IF THE DESIRED STEP IS +1. 


NEXT X 


THE NAME OF THE VARIABLE (X) IS CHECKED WITH THAT OF THE MOST RECENT FOR 
COMMAND. IF THEY DO NOT AGREE, THAT FOR IS TERMINATED AND THE NEXT RECENT 
FOR IS CHECKED, ETC. WHEN A MATCH IS FOUND, THIS VARIABLE WILL BE SET TO 
ITS CURRENT VALUE PLUS THE VALUE OF THE STEP EXPRESSION SAVED BY THE FOR 
COMMAND. THE UPDATED VALUE IS THEN COMPARED WITH THE VALUE OF THE TO 
EXPRESSION ALSO SAVED BY THE FOR COMMAND. IF THIS WITHIN THE LIMIT, 
EXECUTION WILL JUMP BACK TO THE COMMAND FOLLOWING THE FOR COMMAND. IF 
THIS IS OUTSIDE THE LIMIT, EXECUTION CONTINUES FOLLOWING THE NEXT COMMAND 
ITSELF. 


FOR CAN BE NEXTED. THE DEPTH OF NESTING IS LINITED ONLY BY THE STACK 
SPACE. IF A NEW FOR COMMAND WITH THE SAME CONTROL VARIABLE AS THAT OF AN 
OLD FOR COMMAND IS ENCOUNTERED, THE OLD FOR WILL BE TERMINATED AUTOMATIC- 
ALLY. 

STOP COMMAND 

STOP 

THIS COMMAND STOPS THE EXECUTION OF THE PROGRAM AND RETURNS CONTROL TO 
DIRECT COMMANDS FROM THE INPUT DEVICE. IT CAN APPEAR MANY TIMES IN A 
PROGRAM BUT MUST BE THE LAST COMMAND IN ANY GIVEN STATEMENT. I.E. IT 
CANNOT BE FOLLOWED BY A SEMI-COLON AND OTHER COMMANDS. 

DIRECT COMMANDS 

AS DEFINED EARLIER, A STATEMENT CONSISTS OF A STATEMENT NUMBER FOLLWOED 
BY COMMANDS. IF THE STATEMENT NUMBER IS MISSING, OR IF IT IS 0, THE 
COMMANDS WILL BE EXECUTED AFTER YOU HAVE YPED THE CR. ALL THE COMMANDS 
DESCRIBED ABOVE CAN BE USED AS DIRECT COMMANDS. THERE ARE SIX MORE 
COMMANDS THAT CAN BE USED AS DIRECT COMMANDS BUT NOT AS PART OF A 
STATEMENT. 

RUN 


WILL START TO EXECUTE THE PROGRAM STARTING AT THE LOWEST STATEMENT 
NUMBER. 


LIST 
WILL PRINT OUT ALL THE STATEMENTS IN NUMERICAL ORDER. 
LIST 120 


WILL PRINT OUT ALL THE STATEMENTS IN NUMERICAL ORDER STARTING AT 
STATEMENT 120. 


NEW 

WILL DELETE ALL THE STATEMENTS. 

SAVE STARTREK 

WILL SAVE THE PRESENT PROGRAM ON DISK BY WAY OF THE CPM OPERATING 
SYSTEM. IT WILL BE SAVED AS A FILE NAMED "STARTREK.TBI". THIS 
IS NOT A PURE ASCII FILE AS THE LINE NUMBERS ARE STORED IN BINARY. 
LOAD STARTREK 


WILL DELETE ANY PROGRAM IN MEMORY AND WILL LOAD IN A FILE FROM DISK 
CALLED "STARTREK.TBI", IF IT EXISTS, 


BYE «ob ¢ 


WILL RETURN YOU TO THE CPM OPERATING SYSTEM, 


STOPPING THE EXECUTION 


THE EXECUTION OF PROGRAM OR LISTION OF PROGRAM CAN BE STOPPED BY THE 
CONTROL-C KEY ON THE INPUT DEVICE. 


ABBREVIATION AND BLANKS 


YOU MAY USE BLANKS FREELY, EXCEPT THAT NUMBERS, COMMAND KEY WORDS, AND 
FUNCTION NAMES CANNOT HAVE EMBEDDED BLANKS. 


YOU CAN TRUNCATE ALL COMMAND KEY WORDS AND FUNCTION NAMES AND FOLLOW 
EACH BY A PERIOD. "PR.", "PRI.", "PRIN." ALL STAND FOR "PRINT". 
ALSO THE WORD LET IN LET COMMANDS MAY BE OMITTED. THE "SHORTEST" 
ABBREVIATION FOR ALL THE KEY WORDS ARE AS FOLLOWS: 


A.=ABS F.=FOR GOS .=GOSUB G.=GOTO 
IF=IF I.=INP IN.=INPUT L.=LIST 
LO.=LOAD N.=NEW N.=NEXT O.=OUTPUT 
P,=PEEK P.=POKE PR.=PRINT REM=REMARK 
R.=RETURN R.=RND R.=RUN S.=SAVE 
S.=SIZE S.=STEP S.=STOP TO=TO 
U.=USR W.=WAIT 


NULL AND NONE-OF-THE-ABOVE = LET 

ERROR REPORT 

THERE ARE ONLY THREE ERROR CONDITIONS IN TINY BASIC. THE STATEMENT WITH 
THE ERROR IS PRINTED OUT WITH A QUESTION MARK INSERTED AT THE POINT 
WHERE THE ERROR IS DETECTED. 


(1) WHAT? MEANS IT DOES NOT UNDERSTAND YOU. EXAMPLE: 


WHAT? 

260 LET A=B+3, C=(3+4?. X=4 

HOW? 

210 P?TINT "THIS" WHERE PRINT IS MISSTYPED 


(2) HOW? MEANS IT UNDERSTANDS YOU BUT DOES NOT KNOW HOW TO DO IT. 


HOW? 

310 LET A=B*C?+2 WHERE B*C IS LARGER THAN 32767 
HOW? 

380 GOTO 412? WHERE 412 DOES NOT EXIST 


(3) SORRY? MEANS IT UNDERSTANDS YOU AND KNOWS HOW TO DO IT BUT THERE 
IS NOT ENOUGH MEMORY TO DO IT. 


ERROR CORRECTIONS 


IF YOU NOTICE AN ERROR IN TYPEIN BEFORE YOU HIT THE CR, YOU CAN DELETE 
THE LAST CHARACTER BY THE RUB-OUT KEY OR DELETE THE ENTIRE LINE BY THE 
"\" KEY. TINY BASIC WILL ECHO A BACK ARROW "_" FOR EACH RUB-OUT. 

ECHO FOR BACK-SLASH CONSISTS OF A LF, A CR, AND AN UP ARROW. 


TO CORRECT A STATEMENT, YOU CAN RETYPE THE STATEMENT NUMBER AND THE 
CORRECT COMMANDS. TINY BASIC WILL TRPLACE THE OLD STATEMENT WITH THE NEW 
ONE. 


TO DELETE A STATEMENT, TYPE THE STATEMENT NUMBER AND A CR ONLY. 


VERIVY THE CORRECTIONS BY "LIST NNNN® AND HIT THE CONTROL-C KEY WHILE 
THE LINE IS BEING PRINTED. xb 


D> 
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& 


POLY-vu 
#PV119 


. CA 99503 


K&M Company 
é 


TORRANC 


| 


S 
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-CATALOGOO3 
ACE BAS 
AMAZE BAS 
ANIMAL BAS 


BAGELS BAS 
BAGELS2 BAS 
BIOPRINTBAS 
BLKFRI BAS 
BLKFRI2 BAS 
CANNONS BAS 
CHASE BAS 
CHOMP BAS 
COMBINE BAS 


CORE BAS 
CORETESTBAS 
CRAPS BAS 
EUCLID’ BAS 
FIB BAS 
FIT BAS 


FORMAT BAS 
FORMAT FMI 


HANG BAS 
More.. 
HELLO BAS 
KENO BAS 
LANDER- BAS 
LANES BAS 
LEM BAS 
LOAN BAS 
LOVE BAS 
PLOT2 BAS 
POET BAS 
README FMI 
S/TREK BAS 
STARS BAS 
STARTREKBAS 
STORY BAS 
STRIKES BAS 
TREKINST 
TREKINSTDOC 
TTT BAS 
VOLUMESADOC 
VOLUME3BDOC 
WUMPUS' BAS 
43 file(s). 


CPMUG vol. 3 - 10/19/85 


(TREKINST.DOC added 11/12/85) 


20 directory entries remaining. 


C> STAT O: 


Bytes Remaining On O: 28k 


C> 


TYPE -CATALOG.003 
“VOLUME 3 


VARIOUS BASIC E GAMES AND PROGRAMS 


NUMBER SIZE NAME COMMENTS 

CATALOG .3 CONTENTS OF CP/M VOLUME 3 

VOLUME3A.DOC COMMENTS ON SOME PROGRAMS 

VOLUME3B.DOC COMMENTS ON OTHER PROGRAMS 
3.1 2K ACE.BAS BASIC-—E PROGRAM. SEE DOC'S 
3.2 4K AMAZE .BAS BASIC-E PROGRAM. SEE DOC'S 
3.3 2K ANIMAL.BAS BASIC-E PROGRAM. SEE DOC'S 
3.4 2K BAGELS .BAS BASIC-E PROGRAM. SEE DOC'S 
3.5 6K BAGELS2.BAS BASIC-E PROGRAM. SEE DOC'S 
3.6 7K BIOPRINT.BAS BASIC-E PROGRAM. SEE DOC'S 
‘3.7 11K BLKFRI.BAS BASIC-E PROGRAM. SEE DOC'S 
3.8 10K BLKFRI2.BAS BASIC-E PROGRAM. SEE DOC'S 
3.9 6K CANNONS .BAS BASIC—~E PROGRAM. SEE DOC'S 
3.10 3K CHASE .BAS ° BASIC-E PROGRAM. SEE DOC'S 
3.11 2K CHOMP .BAS BASIC-E PROGRAM. SEE DOC'S 
3.12 1K COMBINE .BAS BASIC-E PROGRAM. SEE DOC'S 
3.13 1K CORE.BAS BASIC-E PROGRAM. SEE DOC'S 
3.14 1K CORETEST.BAS BASIC-E PROGRAM. SEE DOC'S 
3.15 4k CRAPS.BAS BASIC-E PROGRAM. SEE DOC'S 
3.16 1K EUCLID.BAS BASIC-E PROGRAM. SEE DOC'S 
3.17 1K FIB.BAS BASIC-E PROGRAM. SEE DOC'S 
3.18 1K FIT.BAS BASIC—-E PROGRAM. SEE DOC'S 
3.19 4k FORMAT .BAS BASIC-E PROGRAM. SEE DOC'S 
3.20 1K FORMAT .FMI INSTRUCTIONS FOR FORMAT.BAS IN 

FORMAT CODE 
3.21 5K HANG .BAS : BASIC-E PROGRAM. SEE DOC'S 
3.22 5K HELLO.BAS BASIC-E PROGRAM. SEE DOC'S 
3.23 7K KENO.BAS ; BASIC-E PROGRAM. SEE DOC'S 
3.24 5K LANDER .BAS BASIC-E PROGRAM. SEE DOC'S 
3.25 BK LANES .BAS BASIC-E PROGRAM. SEE DOC'S 
3.26 7K LEM .BAS BASIC-E PROGRAM. SEE DOC'S 
3.27 3K LOAN .BAS BASIC-E PROGRAM. SEE DOC'S 
3.28 2K LOVE .BAS BASIC-E GRAPHIC 
3.29 2K PLOT2.BAS BASIC-E PROGRAM. SEE DOC'S 
3.30 4K POET .BAS BASIC-E PROGRAM. SEE DOC'S 
3.31 6K README .FMI ANOTHER FORMAT SOURCE WITH NOTES 
ON THE AUTHOR, ON ML8O AND ON SPAT 

3.32 5K S/TREK.BAS BASIC-E PROGRAM. SEE DOC'S 
3.33 4K STARS .BAS BASIC-E PROGRAM. SEE DOC'S 
3.34 27K STARTREK.BAS BASIC-E PROGRAM. SEE DOC'S 
3.35 7K STORY.BAS BASIC-E PROGRAM. SEE DOC'S 
3.36 4k STRIKES .BAS BASIC-E PROGRAM. SEE DOC'S 
3.37 7K TREKINST INSTRUCTIONS FOR STARTREK.BAS 
3.38 7K TTT .BAS BASIC-E PROGRAM. SEE DOC'S 
3.39 9K WUMPUS .BAS BASIC-E PROGRAM. SEE DOC'S 


0>3.375 6K TREKINST .DOC Edited version of startrek instructions. 


TYPE VOLUME3A. DUOC 
Z0SO'S SOFTWARE REVIEW 


FORMAT.BAS 

THIS IS A CLEVER LITTLE PROGRAM FOR TEXT JUSTIFICATION. IT IS SLOW AND MOST 
UNFORTUNATELY IT DOES NOT SAVE JUSTIFIED COPY ON DISK. THIS PREVENTS IT FROM 
BEING USEFUL FOR PRODUCING MULTIPLE COPIES OF A SINGLE LETTER. IF SOMEONE 
WERE TO ADD FILE CREATION TO THIS PROGRAM IT WOULD SURELY EARN ZOSO'S 'CUM- 
LAUDE' AWARD. STILL IT IS NICE FOR ONE OR TWO COPIES OF THE SAME THING. WHEN 
YOU RUN THIS PROGRAM DO NOT ASSUME THAT YOUR DOS HAS DIED; AS MENTIONED 
ABOVE, IT IS QUITE SLOW. ITS SPEED IS INVERSELY PROPORTIONAL TO THE LENGTH 
OF THE FILE IT IS FORMATTING. 


STRIKE9.BAS 

BASED ON THE ERSTWHILE TV GAME SHOW, 'HIGH-ROLLERS', THIS REPRESENTS ITSELF 
AS A 'GAME YOU CAN'T WIN'. THIS IS TRUE, SINCE LOGICAL TRAVESTIES IN THE 
PROGRAM INVALIDATE YOUR WINNING MOVES. A TYPICAL END-GAME POSITION MIGHT BE: 
"YOUR ROLL: 4 5 [TOTAL 9], ONLY THE '9' REMAINS; WHAT NUMBER TO REMOVE ?... 
IF YOU FEEL THAT YOUR ROLL OF 4 & 5 TOTALS 9, BE ALERTED TO A VERY 'C'RUDE 
AWAKENING. THIS GAME REQUIRES INTEGER ADDITION OF THE SUM OF TWO DICE - 

IT WILL CERTAINLY REJECT AN HONEST WINNING MOVE... SMALL WONDER THAT IT IS 
AN 'UN-WINNABLE' GAME. IF YOU FEEL LIKE A DOWNTRODDEN SOT, PERHAPS THIS GAME 
WILL FUEL YOUR EGO PERFECTLY. 


LANES .BAS 

WHY WOULD SOMEONE WRITE A CLEVER GAME LIKE THIS AND IGNORE INSTRUCTIONS ? 
WHEN THIS GAME SIGNS ON IT ASKS IF ANY OF THE PLAYERS WANT RULES, IT THEN 
PRINTS "SORRY, NO INSTRUCTIONS AVAILABLE NOW" ON THE CONSOLE. DESPITE THIS 
QUITE A FEW PEOPLE HAVE PLAYED AND ENJOYED THIS GAME, WITH NO ONE HAVING 
THE SLIGHTEST IDEA WHAT THE OBJECTIVE WAS OR HOW TO STRATEGICALLY PURSUE 
SAID OBJECTIVE. DESPITE THE FACT THAT I LIKE THIS GAME, I FEEL THAT IT IS 
AN EXECRABLE PRACTICE TO SUBMIT UNDOCUMENTED SOFTWARE. NOBODY LIKES TO TYPE, 
BUT NOT EVERYONE HAS A COMPLETE LIBRARY OF ALL THE MAGAZINES IN WHICH GAMES 
LIKE THIS WERE ORIGINALLY PUBLISHED. 

P.S. THE RULES FOR THIS CAN BE FOUND IN JUNE '77 INTERFACE AGE. 


COMBINE.BAS 

PLOT2.BAS 

FIT.BAS 

EUCLID.BAS 

FIB.BAS 

I CANNOT GET PLOT2 TO RUN - SO WHAT. FIT IS A CURVE FITTING PROGRAM. FIB IS 
A FIBONACCI NUMBER GENERATOR FOR THOSE OF YOU WHO NEED ONE. EUCLID DOES JUST 
WHAT YOU THINK. ALL THINGS ARE SUBJECTIVE, BUT THIS REVIEWER ABHORS THE SORT 
OF PROGRAM THAT IS MORE SUITED TO THE POCKET CALCULATOR. THESE FOUR MOST 
CERTAINLY QUALIFY. << LATE FLASH >> COMBINE.BAS: THIS IS THAT EVERYDAY UTILITY 
WHICH TELLS THE USER HOW MANY COMBINATIONS EXIST OF [N] NUMBERS TAKEN [R] 

AT A TIME. WERE IT NOT FOR THE PROBLEM OF 8 BIT OVERFLOW, ONE COULD DE- 
TERMINE JUST HOW MANY WAYS THEIR GRADUATING CLASS OF 300 COULD HAVE LINED 

UP FOR THEIR GRADUATION PORTRAIT. THE MIND BOGGLES. 


BIOPRINT.BAS 
WHEN FIRST I SAW THIS PROGRAM, IT PRINTED UGLY CURVES, IT WAS RIDDLED WITH 
GROSS LOGIC FLAWS, AND IT WAS SLOW. I TOOK IT UPON MYSELF TO RESCUE IT. IF 
THE ORIGINAL PROGRAM WAS STARTED ON CERTAIN DAYS, IT WOULD SKIP THE FIRST 
SATURDAY IT ENCOUNTERED; IF STARTED ON CERTAIN OTHER DAYS IT WOULD SKIP 
ALL SATURDAYS !! ALL OF THIS HAS NOW BEEN CORRECTED, AND IT NOW PRINTS PAGI- 
NATED BIORHYTHMS WHICH ARE FAIRLY ATTRACTIVE, AND BY PLOTTING EVERY 24 HRS. 
INSTEAD OF EVERY 12 HRS., THE THROUGHPUT OF THIS HAS BEEN DOUBLED. SINCE 
For RATHER FOND OF THE WHOLESALE IMPROVEMENTS IN THIS PROGRAM, I'LL GIVE 

AN 'A-'. 


por 


STARTREK.BAS ie: 


DESPITE SEVERAL OUTRKS WHTCH ARE NOT DOCIIMENTED THTS TS ONE OF THE VERY 


BEST STARTREKS THAT THIS REVIEWER HAS EVER SEEN. LOOK THROUGH THE CODE, 
YOU WILL FIND CERTAIN ELEMENTS WHICH WERE WRITTEN INTO THE SOURCE, BUT 
WHICH DO NOT OCCUR IN ACTUAL PLAY. WE LEAVE IT TO YOU TO EXPERIMENT. I 
SUGGEST REMOVING THE PROMPT/INPUT RELATING TO INSTRUCTIONS NEAR BEGINNING 
OF PROGRAM. THE INSTRS. ARE TOO LONG TO MEMORIZE, AND ONCE THE GAME HAS 
BEGUN, THEY CANNOT BE REVIEWED. THE FILE 'TREKINST' SHOULD BE EDITED TO 
REMOVE ALL THE QUOTE MARKS, AND PRINTED AS HARD COPY FOR REVIEW DURING 
THE GAME. OTHERWISE, A WINNER !1!! 


HELLO.BAS 

ANIMAL.BAS 

STORY .BAS 

THESE ARE PSEUDO-INTERACTIVE GAMES IN WHICH ONE 'CONVERSES' WITH THE COM- 
PUTER BY ANSWERING THE SAME QUESTIONS WITH DIFFERENT ANSWERS AND THEREBY 
GETTING A 'NEW' OUTPUT FROM THE PROGRAM. IF YOUR KIDS ARE OLD ENOUGH TO READ, 
RUN ONE OF THESE AND ENJOY 30 MINUTES PEACE, 


S/TREK.BAS 

AS THE FILENAME IMPLIES, THIS IS AN ABBREVIATED VERSION OF STARTREK. SOFTWARE 
JUNKIES, YOU'VE GOT A COLLECTOR'S ITEM HERE. IGNORE THE FULL-BLOWN STARTREK 
ON THIS DISK! IT (STARTREK) CREATES GRAPHIC REPRESENTATIONS OF SPACE COMBAT, 
AND If IS SO HARD TO LEARN THAT YOU WOULD BE FAR BETTER OFF WITH THIS EASY- 
TO-LEARN SUBSET (S/TREK.BAS). BEFORE YOU HAVE ENTERED YOUR 20TH CARRIAGE- 
RETURN, THE GREAT INTRA-GALACTIC CONFLICT WILL HAVE BEEN DECIDED. THE KIDS 
ARE WELCOME FOR THIS ONE, AND SO IS THAT SENILE OLD AUNT THAT YOU CAN'T 
QUITE DECIDE WHAT TO DO WITH. 


STARS.BAS 

FIRST PUBLISHED AS 'SHOOTING STARS', A COMPACT, FUN GAME; WELL-DOCUMENTED, 
WORKS WELL. IT WILL NOT BE YOUR LIFE'S AMBITION TO LEARN HOW TO MASTER THIS, 
BUT IT IS A SMALL 'PYRAMID' CONSTRUCTED BY HONEST CRAFTSMEN. I MEAN THIS AS 
A COMPLIMENT. 


CORE.BAS 

CORETEST.BAS 

THE SOURCE CODES OF THESE IMPLY THAT ONE CAN DETERMINE VALUABLE INSIGHTS 
INTO THE QUALITY OF SOMEBODIES' RAM BOARDS. MIND YOU, THESE ARE WRITTEN 
IN BASIC-E. A HARDWARE TEST IN BASIC-E COULD, IN FACT, BE A PRECURSOR OF 
PORN-FLICKS IN ML-80... GRUNT, WHEEZE..... 


LEM.BAS 

LANDER. BAS 

YOUR SPACE CAPSULE IS IN A GRAVITY-FIELD, AND YOUR FUEL IS FINITE; MAKE A 
SMOOTH LANDING - DON'T BET ON IT - THESE ARE AMONGST THE MOST WIDELY CIRCULATE 
GAMES WHICH EXIST. BOTH ARE GOOD, DAMNED GOOD IN FACT, COMPARED TO ALMOST 

ANY OTHER IMPLEMENTATION OF EITHER OF THESE WHICH HAVE BEEN PREVIOUSLY 
SUBMITTED. ONCE AGAIN, GOOD PROGRAMMING MAKES THE DIFFERENCE. 


KENO.BAS 

TO FIND OUT JUST HOW OVERWHELMING THE ODDS AGAINST WINNING THIS GAME REALLY 
ARE, A SABBATICAL TO NEVADA IS RECOMMENDED. UNLESS YOU ARE DRIVEN BY FORCES 
THAT YOU CAN'T EXPLAIN, YOU WILL PROBABLY GIVE UP BEFORE YOU HAVE EVER WON 
EVEN TEN DOLLARS. IT SURE COULD USE A TRIO AND SOME SHOWGIRLS TO LIVEN 
THINGS UP A BIT. 


POET.BAS 
THIS IS A (SHORT) POEM GENERATOR. GET HIGH, RUN IT SEVERAL TIMES, THEN MOVE 
ON TO THE NEXT ONE. 


HANG. BAS 

TTT.BAS 

UNDOUBTABLY, WHEN YOU GOT YOUR BASIC-E DISKETTES, THESE WERE AMONGST THE 
'FREEBIES' THAT WERE INCLUDED. HANG.BAS NOW WORKS. THE WORD YOU MUST GUESS 
WILL BE TRULY RANDOM; BUT, BE HONEST, HAVEN'T YOU ALMOST MEMORIZED ALL 

THE WORDS IN THE DATA TABLE.... NO CHALLENGE (ANYMORE). TTT.BAS - TO PARA- ae 
PHRASE CHIIRCHILT. "NEVER HAS SO MIICH CODE GTVEN SO LITTLE TO A 3 BY 3 


MATRIX GAME’, IT MAY SEEM CLEVER THAT “TYT SEEMS SO CYBERNETIC, BUT IN 
IMMINENT RELEASES, YOU MAY WELL SEE AN EXCELLENT 'OTHELLO' (NO, NOT THAT 
SHORT VERSION THAT WAS RECENTLY PUBLISHED) OR PERHAPS A POKER GAME THAT 
PLAYS WELL TO START, AND IMPROVES ITS LOGIC CONTINUOUSLY DURING PLAY. THESE 
ARE MENTIONED BECAUSE EACH OCCUPIES THE (APPROXIMATE) SAME AMOUNT OF SOURCE 
AS DOES 'TTT.BAS', 


CRAPS.BAS 
A NICE RENDITION OF THIS GAME. LIKE KENO IT STILL NEEDS A BEVY OF BUXOM 
SHOWGIRLS TO PUT IT OVER THE TOP. 


BAGELS.BAS 

MY REVIEW OF THE SOFTWARE ON ANOTHER DISK INDICATED MY FONDNESS FOR THAT 
VERSION OF THIS GAME. THE SAME APPLIES HERE. YOU'VE SEEN IT ONE HUNDRED 
TIMES, BUT THIS IS PROBABLY BETTER THAN WHAT YOU'VE SEEN BEFORE. 


CANNONS.BAS 

AIM YOUR ARTILLERY AT A STATIONARY ENEMY. SOUNDS LIKE A TURKEY-SHOOT, 
DOESN'T IT? THE PERSISTANCE TO MASTER THIS GAME PERHAPS REPRESENTS 

THE MAJOR DIFFERENCE BETWEEN ENJOYING A THANKSGIVING FEAST OR BEING THE 
MAIN COURSE AT SAME. SHELLS AWAY..... 


FINALLY WHEN IT COMES TO THE PROBLEMS OF SOFTWARE EXCHANGE I AM REMINDED 
OF THIS: "THE DOER AND THE THINKER, NO ALLOWANCE FOR THE OTHER....." -— YOU 
DOERS ARE DOCUMENTING YOUR PROGRAMS, AND YOU THINKERS ARE MAKING ME CON- 
TEMPLATE THE PURCHASE OF A MUCH LARGER TRASH RECEPTACLE. 


HAPPY TRAILS... 


ZOSO 


O>TYPE VOLUME3B.DOC 
ZOSO'S SOFTWARE REVIEW - INSTALLMENT 2: 


CHOMP.BAS - THIS IS A CLEVER GAME WHICH INVOLVES THE LOGICAL ATTACK UPON 

A COMPUTER GENERATED 'COOKIE' (SO HELP ME GOD). THIS GAME WAS PUBLISHED 
EARLIER IN ONE OF THE COMPUTER MAGAZINES. THAT VERSION (MAGAZINE) WAS IN 

A WORD, PITIFUL, BUT IT HAD INSTRUCTIONS. THIS REINCARNATION IS, BY 
COMPARISON, EXCELLENT; HOWEVER, THERE ARE NOT ENOUGH DIRECTIONS TO ACQUAINT 
A NEOPHYTE PLAYER WITH THE OBJECTIVE OF THIS GAME. 


AMAZE.BAS - GENERATES A MAZE... I'LL BET YOU'VE SEEN THIS ONE BEFORE. NOTICE 
THAT THE DIMENSIONING STATEMENTS ALLOW FOR A 25 BY 25 CELL MAZE. NO DOUBT 
SOME OF YOU WILL NOT HAVE ENOUGH MEMORY TO DO THIS. IT IS 'IMPRESSIVE' TO 
GENERATE COMPUTERIZED MAZES; HOWEVER, AFTER HAVING DONE A FEW IN BASIC, IT 
BECOMES OBVIOUS THAT THEY TAKE MORE TIME TO GENERATE THAN TO SOLVE. PERHAPS 
THEY SERVE BEST AS PACIFIERS FOR 'COMPUTER WIDOWS' AND CHILDREN. 


CHASE.BAS - A GOOD RENDITION OF A GAME AUTHORED BY HERMAN DE MONSTOY. IT WAS 
ORIGINALLY PUBLISHED IN AN EARLY KILOBAUD. THE GAME HAS IMPROVED IN ITS PRESEN! 
INCARNATION, BUT WHERE ARE THE (FULL) INSTRUCTIONS ? 


BLKFRI2.BAS - A WINNER BY ALL ACCOUNTS. IS TITLED BLKFRI2 SIMPLY BECAUSE 
THERE IS AN EQUALLY GOOD RENDITION OF THE SAME GAME: 'BLKFRI.BAS' AND I 
FEEL THAT BOTH ARE EQUALLY WORTHY OF YOUR ATTENTION. LET'S AWARD THEM BOTH 
WITH OUR HIGHEST ACCOLADE: VERY GOOD , FUN TO PLAY , AND FOR THE AS- 

PIRING PROGRAMMER, A PROJECT AS WORTHY OF THE EFFORT OF FUTURE ENHANCEMENT 
AS ALL THE MYRIAD IMPROVEMENTS WHICH HAVE HAVE BEEN VISITED UPON 'STARTREK'. 


LOAN.BAS - THIS PROGRAM CALCULATES THE INTEREST RATE ON A LOAN. THE USER 
CAN INPUT RATE, NUMBER OF PAYMENTS PER YEAR, AND PAYMENTS PER YEAR. IS IT 
SIMPLE INTEREST OR IS IT COMPOUND INTEREST ?; AND MOST IMPORTANT DOES 

ANYONE CARE? SOME WOULD PREFER PENCIL & PAPER TO FIRING UP THE COMPUTER FOR | 
THIS ONE. ofa 


WUMPUS.BAS - IF I WERE IN CHARGE OF THE WORLD, IL WOULD CERTAINLY PUT TO 
DEATH THE INDIVIDUAL WHO CONCEIVED THIS PARTICULAR GAME (AND ALL THE VAR- 
IETIES OF 'HURKLE' WHICH USUALLY SURFACE IN THE SAME SOFTWARE COLLECTIONS) , 
HOWEVER, THIS 'WUMPUS' IS PROFESSIONALLY DONE. THE PERSON WHO ADAPTED THIS 
FOR BASIC-E HAS NOT YET BEEN ADEQUATELY REWARDED FOR THEIR PATIENCE. 


BAGELS.BAS - AN EXCELLENT VARIANT OF A SHOPWORN IDEA. AN EARLIER RELEASE 


(ALSO CALLED BAGELS) WAS A 4 DIGIT GAME; THIS IS ONLY A 3 DIGIT GAME, 
BUT IS STRUCTURED SO THAT IT IS MORE CHALLENGING (IN GENERAL). A WINNER, 


BUT TRY THE OTHER 'BAGELS' ALSO. 
ACE.BAS - PLAYS 'ACEY-DEUCY' (WITH NO PENALTIES FOR NON-WAGERING). IF THIS 
HAS BEEN COMPUTERIZED, CAN THE FLIP OF A COIN BE FAR BEHIND? ENOUGH SAID. 
ENJOY YOURSELVES IF YOUR RECENT LOBOTOMY HAS NOT YET HEALED... 

'TIL WE MEET AGAIN... 


ZOSO 


O> 


pel 


TREKINST. Doc 


Welcome to: 


This is a game of galactic conflict between the starship 
ENTERPRISE and a surly horde of Klingon Destroyers. You 
are the Captain in charge of the Enterprise and it is your 
duty to eradicate the Klingon menace from the galaxy. 


The galaxy is divided into 64 quadrants in the form of an 
8x8 grid. Each quadrant is further subdivided into an 8x8 
array of 64 sectors. This is the shape of the playing field. 


You will be assigned a starting point somewhere in the gal- 
axy to begin a tour of duty. You have at your disposal the 
wisdom of the officers of the Starship Enterprise to guide 
you as you unleash the full destructive capabilities of the 
Enterprise in your eternal quest for peace in the galaxy. 
Here are the commands that are available to you: 


N-AVIGATE 


This command is used to control your warp drive (FTL). There 
are two variables that you must set in order to use your warp 
drive. The first is the direction. This is set by entering 
a number greater than or equal to one and tess than nine. 

the numbers represent the following directions: 


4 5 6 
\ lL 7s 

3 - E = 47, 
ZY t N 

2 1 8 


The second variable is the distance or warp factor. One warp 
factor is the size of one quadrant.- The warp factor must be 
entered as a decimal fraction to move sectors instead of quad- 
rants. 


S-HORT RANGE SCAN 


This readout shows you a scan of every sector of the quadrant 
that your are in. The symbology is as follows: 


Empty Space 

A Star 

A Ktingon Warship 

A Friendly Starbase 
. Spacecrud 

The Enterprise 


mow A He 
tow uw ow wt 


The short range scan will also give a status report including the 
current condition code. The codes are as follows: 


GREEN = Scanners Clear 

YELLOW = Enterprise Energy Low 

ORANGE = One Klingon in Quadrant 

RED = More Than One Klingon in Quadrant 


L-ONG RANGE SCAN 


This scan shows the conditions in space for one quadrant on each 
side of your present quadrant (which is in the middle of the scan). 
The scan is coded such that the units digit is the number of stars, 
the tens digit is the number of starbases and the hundreds digit is 
the number of Klingons. For example: 


207 = 2 Klingons, no bases, 7 stars 


When you issue a Long Range Scan, the data collected is stored in 
the Galactic Map for access through the Enterprise's central com- 
puter (See 'C'}, 


P-HASER CONTROL 


Phasers are concentrated bursts of coherent energy that have great 
disruptive force at close range. They can be effective against 
several targets at once, and are very fast at firing. You can set 
the amount of energy to use in a single burst but it is easy to 
use up all of your energy if you are not prudent. 


T-ORPEDO CONTROL 


You may fire Photon Torpedoes at the Klingons with this command. You 
must set the torpedo course in the same way it is set for the star- 
ship. Torpedoes take longer to unlimber and give the Klingons more 
opportunity for counter-attacks. Aiming is greatly enhanced through 
the use of the central computer (See 'C'), 


E-NGINEERING 


The 'E' command will put you in touch with the engineering section 

of the Enterprise and they will allow you to set the amount of energy 
that you wish to divert into your shields. Every time you are hit 

by enemy phaser fire your shields will be reduced. If they fall too 
low the damage you suffer will be severe. It is a good idea to set 
them high before going into battle. If you attempt a warp that is 
consuming a lot of energy, engineering will transfer some shield power 
to the warp drives. When you [eave a starbase your shields will be at 
zero, so don't forget to reset them. 


D-AMAGE CONTROL 


Damage control will give a numerical status report on the various 
sensitive devices on board. A positive number indicates that the 
device is still operational. A negative number shows that the device 
is not functioning. Sometimes a particular device can sustain sev- 
eral hits and still remain positive (functional). If the 'D' com- 
mand is issued when the Enterprise is docked, it will serve as a 
summons to the repair facilities of the starbase. The Base repair-—- 
persons will fix all non-functional equipment on board but they do 
consume precious time. 


C-OMPUTER 


This command will put you in direct communications with the central 
computer, an 8080 based system. There are five options available: 


41 = Galactic Map. This is a print of the entire 
galaxy similar to a !ong range scan. Data is 
entered in the G-Map by the 'L' command. 


2 = Status Report. This tells the time remaining 
the number of starbaSes remaining and the num-— 
ber of Klingons remaining. 


3 = Torpedo Target Data. This will give the direc- 
tion and distance to all Klingons in the quad- 
rant. The direction may be used for firing 
photon torpedoes. 


4 = Starbase Navigation Data. This will give the 
direction and distance to the starbase in the 
quadrant. 

5 = Navigator. This wil! assist you in calculating 


the direction and distance to and from any quad— 
rant or sector in the galaxy. 


Good Luck and Good Hunting! 


TYPE README .FMI CPMUG v. 3 

"40/9/77" 

aas 1 

"*DEAR “TONY:" 

aas 1 

"*IN RESPONSE TO YOUR RECENT REQUEST, “I SUBMIT THE FOLLOWING" 

"DATA ON MY EQUIPMENT AND INTERESTS, AS WELL AS SEVERAL NEW" 
@ "Procrams TO ADD TO THE USERS GROUP LIBRARY." 

aas 1 

"*EQUIPMENT:" 

aas 


aas 1 

"*ITMSAI 8080 CABINET, WITH BOTH “IMSAI *M*P*U CARD AND “ITHACA “*AUDIO" 
"*7-80 “M*P*U CARD." 

aas 1 

"“TCOM 'FRUGAL FLOPPY' SYSTEM WITH TWO DRIVES IN “SYNETIC *DESIGNS" 
"CABINET AND “ICOM “F*D*0O*S=*I*I FIRMWARE/SOFTWARE." 

aas 1 

"*A TOTAL OF 36°*K BYTES OF “R*A*M, DIVIDED UP AS 32*K FROM OQ-7*F*F*F AND" 
"4°K FROM “FOOO-*F*F*F*F (NORMALLY CONTAINS MY “I/*O MONITOR) ." 

aas 1 

"2°K OF *P*R*O*M: 1°*K CONTAINS *F*D*0*S=*I*I FIRMWARE, OTHER 1°*K IS BOOTSTRAP" 
"AND DISC DRIVERS FOR *C*P/*M (WITH LOTS OF UNUSED SPACE)." 


aas 1 

"*PROCESSOR “TECHNOLOGY “V*D*M-1 VIDEO INTERFACE." 
aas 1 

"“TARBELL CASETTE INTERFACE." 

aas 1 


"*“BURROUGHS 9350-2 TYPEWRITER TERMINAL (SIMILAR TO “FRIDEN 7000)." 

"*THIS RATHER UNUSUAL TERMINAL IS RUNNING THROUGH AN INTERFACE" 

"OF MY OWN DESIGN, WITH NO SPECIAL SOFTWARE REQUIRED. “IF ANY" 
[ails MEMBER OF THE GROUP HAS ONE OF THESE TERMINALS," 

"(*HERBACH & “RADEMANN IN “PHILADELPHIA SOLD A BUNCH OF THEM LAST" 

"YEAR) “I CAN PROVIDE PLANS, PARTS AND/OR A *P*C BOARD FOR MY" 

"INTERFACE, AS WELL AS SERVICE DATA ON THE TERMINAL ITSELF." 

aas 1 

"*SOFTWARE:" 

aas 


aas 1 

"*T AM SUBMITTING THE FOLLOWING PROGRAMS TO THE USERS GROUP:" 

aas 1 

"*M*L80: “BY COLLECTING PIECES FROM VARIOUS SOURCES AND" 

"MAKING A FEW PATCHES MYSELF, “I HAVE COME UP WITH A REASONABLY" 
"CLEAN SET OF MODULES FOR THE *M*L80 COMPILER." 

aas 1 

"*xX*D*I*R: “THIS IS SIMILAR TO MY '*W*D*I*R' PROGRAM, EXCEPT THAT IT" 
"ONLY PUTS THREE FILENAMES ON A LINE, AND REPORTS THE FILE SIZE" 

"AS WELL AS THE EXTENT NUMBER (IF NON-ZERO). *IT IS WRITTEN IN" 
"“M-L80." 

aas 1 

"*F°O°R*M*A*T: ““THIS *B*A*S*I*C=*E PROGRAM IS A SIMPLE TEXT PROCESSOR THAT" 
"DOES FILLING, JUSTIFICATION, CASE CONTROL, TITLING, AND" 
"PAGINATION. “IT TAKES A “B*A*S*I*C=*E DATA FILE AS ITS INPUT AND" 
"PRODUCES ITS OUTPUT ON THE CONSOLE DEVICE. “MOST COMMANDS" 


"ARE IMBEDDED IN THE INPUT FILE. “LIKE MOST PROGRAMS WRITTEN" 
"IN “B*A*S*I*C="E, IT IS QUITE SLOW (5-10 SECONDS PER LINE) ." 
aas 1 


"*L°AN*E*S: “THIS IS A CONVERSION TO *B*A*S*I*C="E OF THE GAME '*STAR *LANES', 
"WHICH WAS PUBLISHED IN “INTERFACE “AGE MAGAZINE SOME MONTHS" 

"AGO. “IT'S SORT OF A CROSS BETWEEN “STAR “TREK AND “MONOPOLY. -SEE" 
"*INTERFACE “AGE FOR DIRECTIONS." 

aas 14 

"“S*P*A*T: *THIS IS A HEAVILY MODIFIED VERSION OF '*E*X*A*M', WHICH" 

“ALLOWS MODIFICATION OF THE SECTOR RETING EYA@ *: 0 * fottan 


"COMMANDS ARE:" 


QQFN,GQJN 
" LINE FEED DOES THE SAME THING AS '+!'," 
" A MODIFY CURRENT SECTOR IN *A*S*C*I7I." 
" c CLEAR ALL POINTERS AND RESTART *S*P*A‘T" 
" D SELECT DRIVE #" 
" H MODIFY CURRENT SECTOR IN HEX." 
0: Q OR ***C EXIT TO *C*P/*M" 
n S SELECT SECTOR #" 
" T SELECT TRACK #" 
" W WRITE MODIFIED SECTOR TO DISK." 


QQFY,QQJY 

"“IN ADDITION, *S*P*A*T COPIES ALL THE “B*I*0O*S VECTORS INTO ITSELF" 
"DURING START-UP, SO IT SHOULD RUN ON ANYBODY'S HARDWARE." 

"*THE ONLY HARDWARE DEPENDANT ROUTINE IS '*S*T*A*T', WHICH READS" 
"THE DISK CONTROLLER STATUS BYTE (USED ONLY FOR DISPLAY)." 


aas 1 
"*T°I°N*Y*B°A*S: (*BY “BRUCE “SHERRY, “LIVERMORE, “*CA.)" 
"“THIS IS AN" 


"EXTENSION OF “LI*“CHEN “*WANG'S “PALO “ALTO “TINY “B*A*S*I*C, WHICH INCLUDES" 
"COMMANDS TO LOAD AND SAVE “TINY “B*A*S*I*C PROGRAMS ON DISK." 

aas 1 

"“QBJECTIVES:" 

aas 


aas 1 

"“MY MAIN OBJECTIVE IS TO HAVE FUN WITH MY SYSTEM, DOING THINGS" 
"THAT “I DON'T NORMALLY GET THE OPPORTUNITY TO DO ON MY JOB" 
"(°I'M A PROGRAMMER/ANALYST FOR A CONSULTING FIRM IN “N*Y7C)." 
"“THIS INCLUDES TINKERING WITH SYSTEMS SOFTWARE, AND TRYING" 
"OUT NEW LANGUAGES AND PACKAGES AS THEY COME ALONG. “I ALSO" 
"SPEND A LOT OF TIME ON GAMES." 


aas 1 
P"-T ALSO USE MY SYSTEM TO DEVELOP NEW PERIPHERALS FOR THE" 
"*S-100 BUS. “THE *“FRIDEN INTERFACE “~I MENTIONED EARLIER IS" 


"JUST ONE EXAMPLE OF THIS. “I HAVE SEVERAL OTHER DESIGN PROJECTS" 
"IN THE WORKS, WHICH “I'LL NOT TALK ABOUT UNTIL *I CAN SHOW THEM" 
"UP AND RUNNING." 

aas 1 

"*T AM INTERESTED IN APPLICATIONS SOFTWARE FOR THE SMALL BUSINESS" 
"MAN. “I HAVE AN ORDER PROCESSING SYSTEM FOR MY HARDWARE" 

"SALES, WRITTEN IN *“OPUS/1. “ACCOUNTS PAYABLE AND GENERAL LEDGER" 
"ARE IN THE WORKS." 


aas 1 
"“AS EVIDENCED BY THE '*F*O*R*M*A*T! PROGRAM, “I AM ALSO INTERESTED IN" 
"WORD PROCESSING. “I USE '*F*O*R*M*A*T' FOR MOST OF MY CORRESPONDENCE" 


"AND TO FORMAT THE INSTRUCTION MANUALS FOR MY *S-100 PRODUCTS." 

"*T PLAN TO EVENTUALLY RECODE '*F*O*R*M*A*T' IN *A.°*L. OR *M*L80, TO GET" 
"IT UP TO A DECENT SPEED AND ADD SOME MORE FEATURES." 

aas 1 

"“USERS *“LIBRARY:" 

aas 


aas 1 

"*T WOULD LIKE TO RECEIVE THE FOLLOWING ITEMS FROM THE" 

"USERS LIBRARY:" 

Gas 1 

"*SOURCE FOR “X*S*°T°A*T (IF POSSIBLE). “I ALREADY HAVE “X*S“°T*A*T.*C*O*M." 
aas 1 

~ "*A DECENT EXPLANATION OF HOW TO USE '*A*C*T', “THE THREE-PAGE" 

"WRITEUP “I CURRENTLY HAVE IS HOPELESSLY CRYPTIC." 

aas 1 


"CH*ACI°K*U, “A*M*U*S*E, “A*M°A*Z*E, *I°*0*E*X*A°M*P, AND ANY OTHER EXAMPLES YOU 


"HAVE OF HOW TO USE '*A*C*T'." 
aas 1 
NaneTpe cn 


aas 1 
"*B°O*O°T#HA7 “AN 

gas 1 

"-B*I-O°S#477A - “I'M ESPECIALLY CURIOUS HOW YOU LET ~C*P/“M KNOW YOU'VE" 
"TAKEN AN EXTRA TRACK FOR THE BOOT." 

gas 1 

"*P*R°N*T AND *P*R*I*N*T" 

gas 1 

"°M*ESM*T*S*T" 

gas 1 

"A°S*S*I°G"N AND “V*B*I707S" 

gas 1 

UAM*A*Z*E" 

oas 1 

W*T“R*ATIONS 

gas 1 

"-v"B°I707S31 AND *B*0*0*T31" 

gas 1 

"*T°D*I°R AND “I*G*O*P*Y" 

gas 1 

mp-T-org" 

gas 1 

"*IT'S GENERALLY IMPOSSIBLE TO CATCH ME AT MY OFFICE, BUT ~1" 
"CAN USUALLY BE REACHED AT HOME WEEKDAY EVENINGS. “~LOOKING" 
"FORWARD TO HEARING FROM YOU AGAIN." 

gas 1 

"*YOURS “TRULY," 

gas 4 

QQFN,QQUN 

"BRUCE “R. “RATOFF" 

"*BOX 28-*D, “APT 137B" 

"4 *MARINEVIEW “*PLAZA" 

"*HOBOKEN, “N*d 07030" 

"201-963-0848" 


O>TYPE FORMAT.FMI 
QGC,°“COMMANDS FOR *R*U*N*O*F*F “VERSION 8/22/77 


aas 1 
QQFN,QQUN 

“BACKSLASH “PRINTS AS EXACTLY ONE SPACE 
“UP-ARROW “CAPITALIZE THE FOLLOWING CHARACTER 
“acacp “SKIP TO NEXT PAGE 

“a-a*S\N “SKIP N LINES 

“acarc “CENTER THE NEXT LINE 

“Q*Q*F*Y “ENABLES LINE FILLING 
“Q°Q*F°N “DISABLES LINE FILLING 

sa°a sty “ENABLES JUSTIFICATION 
“Q*Q*UTN “DISABLES JUSTIFICATION 

o> 


BAS2-1 S/TREK 


BASIC~E COMPILER VER 2.1 


1: 
2% 


REMARK - STAR TREK BY DAN DRUID FOR BASIC-E 
RANDOMIZE 

DIM S(7,2) 

FOR I = 1 TO 2 

FOR J = 1 TO 6 

LET S(J,I) = 1 

NEXT J 

LET S(7,1I) = 0 

NEXT I 

REM GENERATE RANGE AND BEARING 


"STARTREK - VERSION 1.0" 
"COMMANDS ARE:" 


"G 


FIRE FORWARD PHASORS" 
FIRE REAR PHASORS" 

FIRE PHOTON TORPEDO" 
MANEUVER TO ATTACK" 
ATTEMPT TO BREAK CONTACT" 
SELF-DESTRUCT" 

= SURRENDER" 

OOD LUCK" 


PRINT "ENTER STAR DATE" 
INPUT A 

LET A2 = -ABS(A/1000) 
RANDOMIZE 

LET R = 10°7*RND 
RANDOMIZE 

LET B = 180*RND 

LET I = 1 

REMARK - ODD MOVES ARE THE ENTERPRISE, EVEN KLINGON 
PRINT "KLINGON APPROACHING" 

PRINT "RANGE = ";R;" KM, BEARING = ";B;" DEGREES." 
INPUT "COMMAND";C 

PRINT "WORKING" 


PRINT C 
I=l 
J = 2 
H = 0 


ON C GOSUB 790, 920, 1040, 1140, 1180, 1250, 1310 
GOTO 1360 

REMARK - KLINGON MOVE SELECTION 

I-22 

REMARK - CHECK KLINGON PHASOR STATUS 

W = S(1,1I)+8(2,1) 

J=il 

IF S(3,I) = 1 AND R>3E+06 AND B<100 THEN 710 
IF W>0 AND R<3E+06 THEN 540 

IF W<>0 THEN 480 

REMARK - ATTEMPT TO BREAK CONTACT 

PRINT "KLINGON ATTEMPTS TO BREAK CONTACT" 
C= 5 

GOSUB 1180 

GOTO 1920 

PRINT "KLINGON MANEUVERING TO ATTACK" 
C=4 

GOSUB 1140 

B= 0 

H= 0 

GOTO 1920 

PRINT "KLINGON FIRES PHASOR" 

c=] 

IF B<90 THEN 640 

IF S(2,1)=0 THEN 600 


Aeet 


GOTO 1360 

B = B-90 

GOSUB 790 

B = B+90 

GOTO 1360 

IF S(1,I) = 0 THEN 670 

GOSUB 790 

GOTO 1360 

B = B+90 

GOSUB 920 

B = B-90 

GOTO 1360 

PRINT "KLINGON FIRES PHOTON TORPEDO" 
C = 3 

B2 =B: B= 40 

GOSUB 1040 

B = B2 

GOTO 1360 

REMARK - FIRE FORWARD PHASORS 
H = 0 

IF S(1,I) <> 0 THEN 830 

PRINT "FORWARD PHASORS NOT OPERATIONAL" 
IF I = 1 THEN 260 

R1 = 1-.2*(R/1E+06) 

Bl = (90-B)/90 

IF Bl < 0 OR R > 5E+6 THEN 900 
REMARK - GENERATE RND(0-1) 

IF Rl < RND THEN 900 


H=1 
P=4 
RETURN 


REMARK - REAR PHASOR 

IF S(2,1I) <> 0 THEN 960 
PRINT "REAR PHASORS NOT OPERATIONAL" 
REMARK - 

IF I = 1 THEN 260 

H = 0 

Rl =1-0.2*R*1E-06 

REMARK - RANGE BEARING CHECK 
IF R>5E+06 OR B<90 THEN 1030 
IF R1<RND THEN 1030 

1 


mau m 
is] 
tau 


2 
URN 
0 
IF §(3,1I1)<>0 THEN 1080 
PRINT "PHOTON TORPEDO NOT OPERATIONAL" 
IF I=l1 THEN 260 
IF R<2E+06 OR B>90 THEN 1130 


R2 = (1-B/90)*(2*R/1E+08) 
IF R2 < RND THEN 1130 


H=1 

P= 8 

RETURN 

R = R*(1-0.5%*S(4,1)) 
B= 0 

H = 0 

RETURN 


R = R*(145(4,1) +0.05*S(6,1)) 
IF R>1E+08 THEN 1230 

PRINT "CONTACT NOT BROKEN” 
H = 0 

RETURN 

PRINT "CONTACT LOST" 

GOTO 10 


a. «wm = + 


woe 


FOR I=10 TO 1 STEP -1 
PRINT I 

NEXT I 

PRINT "BOOM" 

GOTO 10 


PRINT"MESSAGE FROM KLINGON*** I ACCEPT YOUR SURRENDER" 


PRINT "PREPARE TO BE BOARDED" 
PRINT "*** MESSAGE FROM STARFLEET COMMAND" 
PRINT "YOU COWARD" 

GOTO 10 

LET J=3-I 

IF C>3 THEN 1920 

REMARK - DAMAGE ASSESSMENT 

IF H<>0 THEN 1440 

PRINT "MISS" 

GOTO 1920 

REM 

REM 

PRINT "HIT" 

D = P*(S(5,Jd)) 

IF D<=2 THEN 1480 

D= 2 

8(7,3) = S(7,3)4+D 

§(5,J) = S(5,3)-P/100 
Z=10-INT(S(7,J)) 

IF J=1 THEN 1580 

REMARK - DAMAGE DONE TO KLINGON 
PRINT"SCANNER REPORT ON KLINGON" 
IF Z2>1 THEN 1610 

PRINT "KLINGON DESTROYED" 

GOTO 10 

REMARK 

PRINT "ENTERPRISE DAMAGE REPORT" 
IF Z>0 THEN 1610 

Z2=1 

ON Z GOTO 1620, 1640, 1850, 1730, 1730, 1780, 1780, 
PRINT" ENTERPRISE DESTROYED" 

GOTO 10 

PRINT"WEAPON SYSTEMS DESTROYED" 
PRINT"WARP DRIVE DESTROYED" 
PRINT"MAJOR STRUCTURAL DAMAGE" 
PRINT"SHIELDS BUCKLING" 


S(1,J) = 0 
8(2,J) = 0 
8(3,J) = 0 
8(4,J) = 0 
GOTO 1920 


PRINT"PHASORS DESTROYED" 

PRINT"MINOR DAMAGE AMIDSHIPS" 
PRINT"SHIELDS WEAKENING" 

8(1,3)=0 : S(2,J) = 0 

GOTO 1920 

PRINT"FORWARD PHASORS DESTROYED" 
PRINT"MINOR DAMAGE AMIDSHIPS" 
PRINT"SHIELDS WEAKENING" 

S(1,J3) = 0 

GOTO 1920 

PRINT"SHIELDS HOLDING -- NO DAMAGE" 
GOTO 1920 

PRINT"WEAPONS SYSTEMS DEACTIVATED" 
PRINT"DILITHIUM CRYSTALS OVERHEATING" 
S(1,J) = 0 

8(2,J) = 0 

8(3,d) = 0 

GOTO 1920 


ay : ~ 


1780, 


o 
c\* , 


1830 


197* 
198* 
199: 
200* 
201* 
202* 
203% 
204* 
205* 
206: 
207* 
208* 
209: 
210% 
211* 


1905 
1906 
1920 
1925 
1930 
1940 
1945 
1950 
1960 
1970 
1980 
1990 
2000 
2010 
2020 


ALPHA = .05*(S(6,1)+S(6,2)) 


BETA = S§(4,1)+S(4,2) 
R3 = .5*(BETA + ALPHA) 
RANDOMIZE 

R = R+R3* (RND-.5) *1E+06 
R=ABS (R) 

RANDOMIZE 

B=ABS (B-150+20*RND) 

IF B>180 THEN 2000 
I=eJ 

J = 3-I 

ON I GOTO 260, 360 

B = ABS(360-B) 

GOTO 1970 

END 


0 ERRORS DETECTED 


D> 


RUNK2-0 STARTREK 
BASIC-E INTERPRETER: VER K2.0 


S T A R T R E XK 
ENTER YOUR NAME, CAPTAIN:? MEL 


WELCOME ABOARD CAPTAIN: MEL 
DO YOU WANT INSTRUCTIONS? Y 


Welcome to: 


This is a game of galactic conflict between the starship 
ENTERPRISE and a surly horde of Klingon Destroyers. You 
are the Captain in charge of the Enterprise and it is your 
duty to eradicate the Klingon menace from the galaxy. 


The galaxy is divided into 64 quadrants in the form of an 
8x8 grid. Each quadrant is further subdivided into an 8x8 
array of 64 sectors. This is the shape of the playing field. 


You will be assigned a starting point somewhere in the gal- 
axy to begin a tour of duty. You have at your disposal the 
wisdom of the officers of the Starship Enterprise to guide 
you as you unleash the full destructive capabilities of the 
Enterprise in your eternal quest for peace in the galaxy. 
Here are the commands that are available to you: 


N-AVIGATE 
TYPE 'GO' TO CONTINUE 
? GO 


This command is used to control your warp drive (FTL). There 
are two variables that you must set in order to use your warp 
drive. The first is the direction. This is set by entering 
a number greater than or equal to one and less than nine. 

the numbers represent the following directions: 


4 5 6 
\ I / 

3 - ES 7 
7 I \ 

2 1 8 


The second variable is the distance or warp factor. One warp 
factor is the size of one quadrant. The warp factor must be 
entered as a decimal fraction to move sectors instead of quad- 
rants. 


S-HORT RANGE SCAN 
TYPE 'GO' TO CONTINUE 
? GO 


This readout shows you a scan of every sector of the quadrant 
that your are in. The symbology is as follows: 


Empty Space 

A Star 

A Klingon Warship 
A Friendly Starbase 
Spacecrud 

The Enterprise 


Mev WH +e 
tout t nog 


The short range scan will also give a status report including the 
current condition code. The codes are as follows: 


GREEN = Scanners Clear 

YELLOW = Enterprise Energy Low 

ORANGE = One Klingon in Quadrant 

RED = More Than One Klingon in Quadrant 


L-ONG RANGE SCAN 


This scan shows the conditions in space for one quadrant on each 
TYPE 'GO' TO CONTINUE 

? GO 

side of your present quadrant (which is in the middle of the scan). 

The scan is coded such that the units digit is the number of stars, 

the tens digit is the number of starbases and the hundreds digit is 

the number of Klingons. For example: 


207 = 2 Klingons, no bases, 7 stars 


When you issue a Long Range Scan, the data collected is stored in 
the Galactic Map for access through the Enterprise's central com- 
puter (See 'C'). 


P-HASER CONTROL 


Phasers are concentrated bursts of coherent energy that have great 
disruptive force at close range. They can be effective against 
several targets at once, and are very fast at firing. You can set 
the amount of energy to use in a single burst but it is easy to 
use up all of your energy if you are not prudent. 


T-ORPEDO CONTROL 


TYPE 'GO' TO CONTINUE 
? TGO § 
You may fire Photon Torpedoes at the Klingons with this command. You 
must set the torpedo course in the same way it is set for the star- 
ship. Torpedoes take longer to unlimber and give the Klingons more 
opportunity for counter~attacks. Aiming is greatly enhanced through 
the use of the central computer (See 'C'). 


E-NGINEERING 


The 'E' command will put you in touch with the engineering section 

of the Enterprise and they will allow you to set the amount of energy 
that you wish to divert into your shields. Every time you are hit 

by enemy phaser fire your shields will be reduced. If they fall too 
low the damage you suffer will be severe. It is a good idea to set 
them high before going into battle. If you attempt a warp that is 
consuming a lot of energy, engineering will transfer some shield power 
to the warp drives. When you leave a starbase your shields will be at 
zero, so don't forget to reset them. 


D-AMAGE CONTROL 
TYPE 'GO' TO CONTINUE 
? GO 


Damage control will give a numerical status report on the various 
sensitive devices on board. A positive number indicates that the 
device is still operational. A negative number shows that the device 
is not functioning. Sometimes a particular device can sustain sev- 
eral hits and still remain positive (functional). If the 'D' com- 
mand is issued when the Enterprise is docked, it will serve as a 
summons to the repair facilities of the starbase. The BasSe repair- 
persons will fix all non-functional equipment on board but they do 
consume precious time. 


C-OMPUTER 


This command will put you in direct communications with the central 
computer, an 8080 based system. There are five options available: 


1 = Galactic Map. This is a print of the entire 
galaxy similar to a long range scan. Data is 
entered in the G-Map by the 'L' command. 


2 = Status Report. This tells the time remaining 
the number of starbases remaining and the num- 
TYPE 'GO' TO CONTINUE 
? GO 
ber of Klingons remaining. 


3 = Torpedo Target Data. This will give the direc- 
tion and distance to all Klingons in the quad- 
rant. The direction may be used for firing 
photon torpedoes. 


4 = Starbase Navigation Data. This will give the 
direction and distance to the starbase in the 
quadrant. 

5 = Navigator. This will assist you in calculating 


the direction and distance to and from any quad- 
rant or sector in the galaxy. 


Good Luck and Good Hunting! 


TYPE 'GO' TO CONTINUE 
? GO 


MISSION ADVISORY: STAND BY 

YOUR ORDERS ARE AS FOLLOWS: 

DESTROY THE 16 KLINGON WARSHIPS WHICH HAVE INVADED 

THE GALAXY BEFORE THEY CAN ATTACK FEDERATION HEADQUARTERS 
ON STARDATE 2028 . THIS GIVES YOU 28 DAYS. THERE ARE 

2 STARBASES IN THE GALAXY FOR RESUPPLYING YOUR SHIP. 


TYPE 'GO' WHEN READY TO ASSUME COMMAND. ne 


Welcome to: 


This is a game of galactic conflict between the starship 
ENTERPRISE and a surly horde of Klingon Destroyers. You 
are the Captain in charge of the Enterprise and it is your 
duty to eradicate the Klingon menace from the galaxy. 


The galaxy is divided into 64 quadrants in the form of an 
8x8 grid. Each quadrant is further subdivided into an 8x8 
array of 64 sectors. This is the shape of the playing field. 


You will be assigned a starting point somewhere in the gal- 
axy to begin a tour of duty. You have at your disposal the 
wisdom of the officers of the Starship Enterprise to guide 
you as you unleash the full destructive capabilities of the 
Enterprise in your eternal quest for peace in the galaxy. 
Here are the commands that are available to you: 


N-AVIGATE 


This command is used to contro! your warp drive (FTL). There 
are two variables that you must set in order to use your warp 
drive. The first is the direction. This is set by entering 
a number greater than or equal to one and less than nine. 

the numbers represent the following directions: 


4 5 6 
XN tL 7 

3 - E = 7 
J tN 

2 1 8 


The second variable is the distance or warp factor. One warp 
factor is the size of one quadrant. The warp factor must be 
entered as a decimal fraction to move sectors instead of quad-—- 
rants. 


S-HORT RANGE SCAN 


This readout shows you a scan of every sector of the quadrant 
that your are in. The symbology is as follows: 


Empty Space 

A Star 

A Klingon Warship 

A Friendly Starbase 
Spacecrud 


Huu wt u 


UOA #>* 


E = The Enterprise 


The short range scan will also give a status report including the 
current condition code. The codes are as follows: 


GREEN = Scanners Clear 

YELLOW = Enterprise Energy Low 

ORANGE = One Klingon in Quadrant 

RED = More Than One Klingon in Quadrant 


L-ONG RANGE SCAN 


This scan shows the conditions in space for one quadrant on each 
side of your present quadrant (which is in the middle of the scan). 
The scan is coded such that the units digit is the number of stars, 
the tens digit is the number of starbases and the hundreds digit is 
the number of Klingons. For example: 


207 = 2 Klingons, no bases, 7 stars 


When you issue a Long Range Scan, the data collected is stored in 
the Galactic Map for access through the Enterprise's central com— 
puter (See 'C'). 


P-HASER CONTROL 


Phasers are concentrated bursts of coherent energy that have great 
disruptive force at close range. They can be effective against 
several targets at once, and are very fast at firing. You can set 
the amount of energy to use in a single burst but it is easy to 
use up all of your energy if you are not prudent. 


T-ORPEDO CONTROL 


You may fire Photon Torpedoes at the Klingons with this command. You 
must set the torpedo course in the same way it is set for the star- 
ship. Torpedoes take longer to unlimber and give the Klingons more 
opportunity for counter-attacks. Aiming is greatly enhanced through 
the use of the central computer (See 'C'). 


E-NGINEERING 


The 'E' command will put you in touch with the engineering section 

of the Enterprise and they will allow you to set the amount of energy 
that you wish to divert into your shields. Every time you are hit 

by enemy phaser fire your shields will be reduced. If they fall too 
low the damage you suffer will be severe. It is a good idea to set 
them high before going into battle. If you attempt a warp that is 
consuming a lot of energy, engineering will transfer some shield power 
to the warp drives. When you leave a starbase your shields will be at 
zero, so don't forget to reset them. 


D-AMAGE CONTROL 


Damage control will give a numerical status report on the various 
sensitive devices on board. A positive number indicates that the 
device is still operational. A negative number shows that the device 
is not functioning. Sometimes a particular device can sustain sev- 
eral hits and still remain positive (functional). If the 'D' com- 
mand is issued when the Enterprise is docked, it will serve as a 
summons to the repair facilities of the starbase. The Base repair-— 
persons will fix all non-functional equipment on board but they do 
consume precious time. 


C-OMPUTER 


This command will put you in direct communications with the central 
computer, an 8080 based system. There are five options available: 


1 = Galactic Map. This is a print of the entire 
galaxy similar to a long range scan. Data is 
entered in the G-Map by the 'L' command. 


2 = Status Report. This tells the time remaining 
the number of starbases remaining and the num-—- 
ber of Klingons remaining. 


3 = Torpedo Target Data. This will give the direc- 
tion and distance to all Klingons in the quad- 
rant. The direction may be used for firing 
photon torpedoes. 


4 = Starbase Navigation Data. This will give the 
direction and distance to the starbase in the 
quadrant. 

5 = ° Navigator. This will assist you in calculating 


the direction and distance to and from any quad-— 
rant or sector in the galaxy. 


Good Luck and Good Hunting! 
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-CATALOG004 
ACT DOC 
ACT31 COM 
ACT31UC COM 
AMAZE 


AMUSE 
CALENDAR 
CALENDARCOM 
CALENDARFOR 
FDL 

HAIKU 
IOEXAMP 

Is 

L81 COM 
L82 COM 
L83 COM 
M81 COM 
MAZE COM 
MAZE FOR 
ML SUB 
MLCOPY SUB 
NUMBER MAC 
More.. 

RND FOR 
VOLUME4 DOC 
WDIR COM 
WDIR M80 
XDIR COM 
XDIR M80 
Z-LCTOUC 

29 file(s). 


CPMUG vol. 


33 directory entries remaining. 


DESTAT O: 


Bytes Remaining On O: 68k 


Ds 


4 


5/18/86 


TYPE -CATALOG.004 


VOLUME 4 


ACTOR, ML80 AND EXAMPLES OF FORTRAN-80 CODE 


NUMBER SIZE 


4.1 16K 
4.2 11K 
4.3 11K 
4.4 2K 
4.5 1K 
4.6 16K 
4.7 4K 
4.8 6K 
4.9 2K 
4.10 3K 
4.11 11K 
4.12 11K 
4.13 5K 
4.14 10K 
4.15 20K 
4.16 5K 
4.17 1K 
4.18 1K 
4.19 2K 
4.20 1K 
4.21 1K 
4.22 3K 
4.23 1K 
4.24 4k 
4.25 2K 


Ds 


NAME 


CATALOG. 4 
VOLUME4 . DOC 
ACT.DOC 
ACT31.COM 
ACT31UC.COM 


AMAZE 
AMUSE 
CALENDAR. COM 


CALENDAR. FOR 
FDL 


HAIKU 

IOEXAMP 
L81.COM 
L82.COM 
L83.COM 
M81 .COM 
MAZE.COM 


MAZE.FOR 
ML. SUB 


MLCOPY . SUB 


NUMBER.MAC 


RND.FOR 
WDIR.COM 
WDIR.M80 
XDIR.COM 
XDIR.M80 
Z2-LCTOUC.ACT 


COMMENTS 


CONTENTS OF CP/M GROUP VOL 4 
COMMENTS ON PROGRAMS 

ACTOR MANUAL 

LATEST ACTOR INTERPRETER 

LATEST UPPER-CASE CHARACTER SET 
ACTOR INTERPRETER 

ACTOR PROGRAM 

ACTOR PROGRAM 

OBJECT OF CALENDAR.FOR AND 
NUMBER.MAC. CREATES DISK FILE 
CALLED CALENDAR TRY IT!! 
FORTRAN MAIN AND SUB-PROGRAMS 
ACTOR PROGRAM - CAREFUL WITH THIS 
AS IT CLEANS OUT INPUT FILES 
ACTOR PROGRAM 

ACTOR PROGRAM 

ML80 MODULE - SEE DISKETTE.DOC 
ML80 MODULE - SEE DISKETTE.DOC 
ML80 MODULE - SEE DISKETTE.DOC 
ML80 MODULE - SEE DISKETTE.DOC 
OBJECT OF MAZE.FOR AND RND.FOR 
CREATES A MAZE ON CONSOLE. 

TRY ITI1! 

SOURCE OF MAZE.COM MAIN 
SUBMIT.COM COMMAND FILE TO RUN 
ML80 SOURCE THROUGH EACH MODULE 
AND CLEAN UP AFTERWARDS 
SUBMIT.COM COMMAND FILE TO 
TRANSFER ML80 GROUP VIA PIP.COM 
CALENDAR TITLE GENERATOR WRITTEN 
IN SOURCE CODE FOR FORTRAN-80 
ASSEMBLER. (NOTE SUFFIX MAC DOES 
NOT CONNOTE THAT MACROS ARE 
SUPPORTED. ASSEMBLER IS CALLED 
M80.COM - NOT TO BE CONFUSED WITH 
ML80 MACRO PROCESSOR M81.COM!!!!1!) 
SUB-PROGRAM OF MAZE 

OBJECT OF WDIR.M80 (TRY IT!!) 
ML80 SOURCE FOR WDIR.COM 

OBJECT OF XDIR.M80 (TRY IT!!) 
ML80 SOURCE FOR XDIR.COM 

ACTOR PROGRAM TO CONVERT STD ACTOR 
PROGRAMS TO ACTUC CHARACTER SET 
(Z-NAME DUE TO LAST MINUTE ADD.) 


TYPE VOLUME4.DOC 
ACT 


ACT(OR) IS A TRAK-LIKE STRING PROCESSING LANGUAGE. 
ACT31 IS THE MOST RECENT REVISION OF THE INTERPRETER. THE 
SYNTAX IS DESCRIBED IN ACT.DOC. 


ACTUC IS A VERSION OF THE INTERPRETER USING UPPER-CASE 
CHARACTER SET ONLY. 


Z-LCTOUC IS A PROGRAM WHICH WILL CONVERT A STANDARD ACT 
SOURCE INTO THE ACTUC CONVENTION. THE FILE ITSELF 

INCLUDES INSTRUCTIONS. (THE Z- WAS ADDED TO THE NAME ONLY TO 
ADD IT TO THE CATALOG AT THE LAST MINUTE. RENAME TO SOMETHING 
MORE CONVENIENT) 


AMAZE, AMUSE, HAIKU AND FDL ARE ACTOR PROGRAMS. 


ENJOY. ..eeeeee 


ML80 


ML80 IS AN ASSEMBLY LANGUAGE INCORPORATING SOME HIGH~—LEVEL 
CONTROL CONSTRUCTS. INCLUDED IN THE PACKAGE IS A RECURSIVE 
MACRO PROCESSOR, RELOCATING COMPILER AND LINKING LOADER. 

A LANGUAGE MANUAL IS AVAILABLE FROM DIGITAL RESEARCH, 
DIGITAL SYSTEMS AND NTIS FOR THE COPYING COST. 


THE MODULES SUPPLIED HERE WORK!!!!! THIS IS UNLIKE MOST NOW 
FLOATING AROUND. TRY IT OUT ON XDIR AND WDIR, WRITTEN BY 
BRUCE RATOFF. SEE ML.SUB FOR SEQUENCE. 

FORTRAN 


MAZE AND CALENDAR COM'S ARE WORKING CP/M OBJECTS WHICH CREATE 
A MAZE TO THE CONSOLE OR A CALENDAR DISK FILE RESPECTIVELY. 


THE SOURCES ARE INCLUDED, TOGETHER WITH SUB-PROGRAMS IN FORTRAN 
AND ASSEMBLY LANGUAGE, IN ORDER TO ILLUSTRATE THE CAPABILITIES 
OF MICROSOFT FORTRAN-80. 


MAZE. FOR+RND. FOR=MAZE.COM 
CALENDAR. FOR+NUMBER.MAC=CALENDAR.COM 


Ds 


ACT version 31 
TYPE ACT.DOC 1 10/17/77 


Summary of Actor (ACT) functions 


Introduction 


ACT is a macro text interpreter which runs under a CP/M system 
with more than 16K bytes of RAM. ACT uses the same algorithm as 
TRAC ("TRAC" is a registered trademark of Rockford Research 
Institute) and a set of primitive functions which are similar to 
those in the TRIX interpreter. ACT also uses the special 
characters @{|} in place of TRAC's #(,). ACT has been used to 
control jobs on a large time sharing system and to format 


diskette files; it is generally too slow for efficient human 
interaction. 


Logically (but not necessarly psychologically), the syntax is 
very simple. Program and data are character strings which are 
handled by the same rules. There are three structures: 


{eset 
@{oplargllarg2|...]argn} 
@@{oplargllarg2|...Jargn} 


The first is a literal quote; the contents are passed on as the 
value. The second performs the indicated operation on the 
argument strings and immediately rescannes the resulting value. 
The last form performs the operation and passes the value to the 
next higher level function. Any op or argument may have any of 
the three forms. For more information on the scanning algorithm 
see any of the published descriptions of TRAC. 


There is a version of ACT which uses upper case letters for the 
command names and the special characters “[,]' instead of @{|}*. 
Also, the meta-character is the exclaim (!). 


References 
1. Moll, H; TRIX - An interactive, interpretive language for 
manipulating strings of characters. Lawrence Livermore Lab 


report UCID-30100. 
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3. Moors, C. N.; TRAC, A Text Handling Language. Proc. ACM 20th 
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4. Wegner, Peter; Programming Languages, Information Structures, 
and Machine Organization. McGraw-Hill Book Co., 1968. 
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Execute line 


act 
act <file-name> 
act <file-name> <options> 


If a file name is given, then the ACT macros in the file are read 
first; <file-name> has the general form "d:x.y". The string @in 
is initialized to the characters between "act " and the return. 


As a special case, <options> may be the three characters “hh, 
where ~ is the caret (or up arrow), and hh is a hex page number. 
Free storage is allocated from the end of the interpreter up to, 
but not including, page hh or FBASE if “hh is not given. 


Non-disk I/O and debug 


@{rs|prompt} "read string" 
Value is a line of input from the console (via CP/M call #10), 
or the next string from the input file. Line-feed, return, 
and tab characters from the input file are ignored; a string 
is terminated by the meta-character (%~) or by the end-of-file. 
Comments on the input file are enclosed within matching left 
quotes (*). Input files generally do not end with the 
meta-character. 


@{pslala]...} “print string" 
Each argument (after the "ps") is printed on a separate line; 
but there is no CR-LF after the last argument. 


@{so|message} "send to Octopus" 
The message is sent over the selected Octopus channel. 
Usually the message does not end with an Octopus end-message 
character. The echo is lost. (Note: "Octopus" is the name 
of the LLL time sharing system. The so and ro functions talk 
to Octopus over a serial interface as an ordinary terminal. 
Separate documentation illustrates how this hardware dependent 
function can be patched for different i/o ports.) 


@{rolx|s|l£leom} "read Octopus" 
If the Octopus time-out is greater than zero, then a message 
terminator is sent. This terminator either causes a previous 
"so" message to be delivered or a log-out in case there was no 
previous "so" and the terminator is a control-D. Octopus 
output is then collected in the string @ro until the string x 
is encountered or until the time-out interval passes since the 
last character. The value is s if x was found, otherwise f. 
If s and £ are omitted, the value is null. (Note this 
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inconsistency with the functions gc and in.) A null x will 
always fail to match. 


A non-null last argument (eom) will change the Octopus message 
terminator. The argument eom must be the two hex characters 
which correspond to the terminator. The terminator is 
initially a control-D. 


@{io|x|x]...} “input-output parameters" 

Each argument x is a letter (o,t,m) followed by an associated 

parameter: 
oa selects Octopus channel a. (initial value) 
ob selects Octopus channel b. 
tn sets the Octopus time-out to n seconds. E.g. t120. 
mc redefines the meta-character to be the character c. 
i2) print: terminal output is thru CP/M, "fw" applies. 
d display: direct output, "fw" does not apply. 

Note: this option is hardware dependent. 


@{fwln} "form width" 
The "print string" function will start a new line after n 
characters. The initial form width is 80. However, this does 
not apply if an @{iolp} is in effect. 


@{tn} "trace on" 
Turn the trace mode on and save the previous mode. Note: An 
@{io|d} is implicitly given so that the output will wrap 
around; see the fw function above. 


@{tf} "trace off" 
Restore the previous trace mode, up to eight levels. 


@{nb} "number of blocks" 
Value is the number of sixteen word free storage blocks. 


@{fsIn|m} "free storage" 
Free storage is augmented by the memory locations n up to but 
not including m; n and m are decimal and must be multiples of 
16. 


@{vn} "version number" 
Value is the ACT version number. 
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Disk I/O 


@{o£|file-name|n|s|£} “open file" 
The file name has the general form "d:x.y". If d is omitted, 
the system drive is selected; lower case characters in the 
name are mapped to upper case. The number of the next record 
to read or write is set to n. (Records are numbered 
sequentially starting at zero; each record consists of 128 
characters.) If the open fails the value is f£; otherwise the 
value is s. 


Since only one file can be open at a time, the record number 
of the crrrent file may need to be saved by @{rn}. Also, a 
currently opened output file must be closed before another 
open. 


@{mf|file-name|s|/£} "make file" 
If the named file can be created, the value is s; otherwise 
the value is £. The current: record number is set to zero. 


@{cf£|s]£} "close file" 
The currently opened file is closed. The value is f if there 
is a close error, otherwise s. 


) @{d£} "destroy file" 
The current file is destroyed. 


@{rn} "record number" 
The value is the record number of the next record to read or 
write. This number applies to the currently opened file. 


@{wf|string-name|x|s|f} "write file" 
Characters from the named string, starting with the first, are 
written to the currently opened file. If x is null, then the 
last partial record is not written; instead, the form pointer 
of the named string is left positioned at the remainder. For 
example, the output for the next write could be constructed by 
@{ns|name|@@{in|name}<more output>}. 


If x is non-null, then the first character of x is used to pad 
out the remainder of the record and the record is written. An 
entire record of pad characters is written if the previous 
output ended on a record boundary. 


The value is f if there is a write error, otherwise s. 


@{rf|string-name|m|s|f} "read file" 
The next m records are read from the currently opened file and 
appended to the named string. The value is f if the physical 
re] end of file is reached, otherwise s. 
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- @{rd} "read dialect" 

The value is the text from the currently open file. The file 
is read starting with the record set by the open file. The 
input is processed in the same manner as described for the rs 
function. Thus, one program can load another in the same way 
as is done when a file name is put on the execute line after 
"act". Warning: No of or mf commands can be executed until 
the file has been read. 


Control _ and delay 


@{eqlalbIsIbls|...|bls} or @{eqlalbis|bls|...1£} "equal" 
The value is the first s for which the preceeding b is equal 
to a, where "equal" means string equality. If the last 
argument is not one of a "b-s" pair, then it provides an 
"else" value. 


@{geln|[m|s!£} “greater than or equal to" 
The value is s if n is numericallly greater than or equal to 
m, Otherwise the value is f. 


@{nt|name|s{f£} "null test" 


The value is s if the named string is null, otherwise the 
value is f. 


@f{ex|x} "exit" 
Clear the active and neutral strings; then set the active 
string to x. 


@{st} "stop" 
Return to CP/M. 


@{zz|n} "sleep" 
Sleep for n/10 seconds. 


String ops and hex-to-characters 


@{ns|name|value|name|value|...} "name string" 
Create one or more strings with the given values. 


@{as|name|x|name|x|!...} "append string" 
Append the string x to the named string. 
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@{ss|namelarglarg|...} "segment string" 
Create arguments in the named string. 


@{cl|namelarglarg|]...} or @{namelarglarg|...} "call" 
Return the named string, starting at the first character, with 
the actual arguments substituted for those corresponding 
substrings which were matched by a previous "segment string". 


@{gc|name|n|s|£} "get characters" (4 or more arguments) 
Move the form pointer over n characters, or to the end of the 
form if there are fewer than n characters remaining. The 
characters passed over are put into the string "@gc". Return 
s if there are n characters after the form pointer in the 
named string, otherwise return f. 


@{gc|name]n} "get characters" (3 arguments) 
Like gc with 4 or more arguments except that the value of @gc 
is also the value of this function. 


@{gc |name} 
Return the total number of characters in the named form. 


@{in|name|pls|£} "initial" (4 or more arguments) 
Starting at the form pointer, search for the substring p. The 
characters which are passed over in the search, up to but not 
including p, are put into the string "@in". If p is found 
return s, otherwise return f. The form pointer is left 


positioned after s, or at the end of the form. Null p always 
fails. 


@{in]name/p} “initial" (3 arguments) 


Like in with 4 or more arguments except that the value of @in 
is also the value of this function. 


@{in|name} "initial" (2 arguments) 
Return the characters from the form pointer to the end of the 
form; also set @in to this value. The form pointer is left 
past the end of the form. 


@{cr |name} "call restore" 


Move the form pointer of the named string to the beginning of 
the string. 


@{dd|name|name|...} "delete definitions" 
Delete the named strings. 


@{pk |hex} "pack" 
Return the characters whose hex values are given. 
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@{uk|x} "unpack" 
Return the hex form of the string x. 


Avtennekd 
@{ad|n|n]...} "add" 


10/17/77 


Return the sum of the arguments. Numbers are represented by 
signed decimal integers whose magnitude is less than 32768. 


@{suln|m} "subtract" 
Return n-m. 


@{ml[n[n]...} "multiply" 
Return the product of the arguments. 


@{dv|n|m} "divide" 
Return n/n. 


@{md|n|m} "mod" 
Return n mod m. 


peeeta eeed 


@cb "console break" 


The value of this string is the last console break character. 


@im "idle macro" 
This macro is loaded whenever the active string is 


empty. 


The 


initial value of @im is @{ps/@{rs|.}}, but @im may be changed 


at any time. 
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u u 


The last character of any console imput, other than 

for the @{rs} function, is saved in the string @cb. 
Moreover, if the input character is an ESC, then you 
will be prompted to type one of the letters t, n, or i 
which will turn the trace on (t), turn the trace off (n), 
or reload the idle macro (i). 


Console input will stop output, or cause an immediate 
return from the zz or ro functions. 


Generating a COM file with a preloaded ACT program 


A COM file containing the ACT interpreter and a preloaded macro 
file may be created as follows, assuming a 32K system. 


1. 


3. 


4. 


Append something like the following to your macro file 


@{ns|@im] { 
@{£s]26368]|29184} 
@{ns|@im|{@{ps|@{rs].}}}} 
@{start} 


}} 
@{st} 


where "Start" is the name of your top level macro. Note that 
the fs function adds 6700 hex up to 7200 hex to the free 
storage list after the program is started (step 4). Free 
storage normally extends to FBASE which is 7200 hex in a 32K 
system. 
Load your program by typing 

act macro-file *67 


where "“" is the caret, or up arrow. Free storage will extend 
up to 6700 hex; if your program needs more space, then you 
need more than 32K to make a COM file. The st function at the 
end of your file will return control to CP/M. 
Make a COM file with the SAVE command 

save 103 code.com 
Run the code by typing either of the following 


code 
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code options 


The options will be in the string @in. 


Error messages 
DISK EOF: The rs function is trying to read beyond the end of 


file. 


FREE STORAGE IS EMPTY: The combined storage required for named 


NS 


strings, string names, and active and neutral strings has 
exceeded the allocated memory. At this point, the active and 
neutral strings are cleared and control given to the @im 
macro. The second time this happens, control returns to CP/M. 


STACK OVERFLOW: The number of unprocessed arguments exceeds 
250. The level of nesting or the number of arguments is 
excessive. For example, the number of arguments for a ns 
should not get much over 200. 


POLY-vu 
#PV119 


CPMUG vol. 5 12/10/85 


-CATALOGO05 2K 
21 ASC 8K 
BAS2-0 COM 12K 
BAS2-1 COM 12K 
BIO-FF ASC 5K 
BIORYTH ASC 4k 
BLKFRI2 ASC 10K 
DECISIONASC 2K 
EDTEXT ASC 6K 
FORMAT ASC 2K 
OTHELLO BAS 16K 
OTHELLO DOC 5K 
RADIX ASC 2K 
RECOVERYASC 1K 
RUN2-2 COM 12K 
RUN2-3 COM 12K 
RUNK2-0 COM 12K 
SLOT ASC 4K 
SORT ASC 2K 
STARTREKASC 7K 
SUPTRK3 ASC 14K 
VOLUME5 DOC 1K 
22 file(s). 

41 directory entries remaining. 
C>OSTAT O: 


Bytes Remaining On O: 90k 


C>TYPE VOLUME5.DOC 


BASIC-E 
THIS DISKETTE CONTAINS 2 VERSIONS OF THE BASIC-E COMPILER 
BAS2-0 AND BAS2-1, AND THREE VERSIONS OF THE RUN-TIME 


INTERPRETER RUNK2-0, RUN2-2 AND RUN2-3. THE BUGS AND 

RELATIVE MERITS ARE UNKNOWN. TRY THEM. NOTE THAT IN 

THESE VERSIONS, THE COMPILE TIME OPTIONS ARE PLACED IN 
THE COMMAND NOT IN THE FILE - EG "BAS2-1 WUMPUS $B" 


OTHELLO IS OVERFLOW BASIC-~E PROGRAM FROM VOLUME #9 


MICROSOFT BASIC (AND SIMILAR) 


K&M Company 
=. CA 99503 


TORRANC 


> 


°o 


THE FILES ???7??7??.ASC ARE ASCII SOURCES OF PROGRAMS WRITTEN 
IN MICROSOFT - TYPE BASIC. PROBABLY NEEDS LITTLE PATCHING 
FOR DEC PDP11 EXTENDED BASIC, TDL AND OTHERS. THE SUFFIX 
ASC IS USED TO DISTINGUISH THEM FROM THE TOKEN FILES WITH 


BINARY LINE NUMBERS, 


C> 


WHICH HAVE .BAS SUFFICES. 


TYPE -CATALOG.005 — 


VOLUME 5 


BASIC-E COMPILERS AND INTERPRETERS 
BASIC-E PROGRAMS, CONTINUED FROM VOLUME 3 
MICROSOFT BASIC PROGRAMS 


NUMBER SIZE 


5.1 8K 

5.2 12K 
5.3 12K 
5.4 

5.5 5K 

5.6 4k 

5.7 10K 
5.8 

5.9 2K 

5.10 

5.11 6K 

5.12 2K 

5.13 

5.14 16K 
5.15 5K 

5.16 2K 

5.17 1K 

5.18 12K 
5.19 12K 
5.20 12K 
5.21 4K 

5.22 2K 

5.23 7K 

5.24 14K 
5.25 


NAME 


CATALOG .5 
VOLUMES .DOC 
21.ASC 
BAS2-0.COM 
BAS 2-1.COM 


BIO-FF.ASC 
BIORYTH.ASC 
BLKFRI2.ASC 


DECISION.ASC 


EDTEXT.ASC 
FORMAT. ASC 


OTHELLO. BAS 
OTHELLO.DOC 
RADIX.ASC 
RECOVERY .ASC 
RUN2-2.COM 
RUN2-3 .COM 
RUNK2-0.COM 
SLOT.ASC - 
SORT.ASC 
STARTREK.ASC 
SUPTRK3.ASC 


COMMENTS 


CONTENTS OF CP/M GROUP VOL 5 
COMMENTS 

MICROSOFT BASIC PROGRAM 
BASIC-E COMPILER 
CASIC-E COMPILER 
DELETED 

MICROSOFT BASIC PROGRAM 
MICROSOFT BASIC PROGRAM 
MICROSOFT BASIC PROGRAM 
DELETED 

MICROSOFT BASIC PROGRAM 
DELETED 

MICROSOFT BASIC PROGRAM 
MICROSOFT BASIC PROGRAM 
DELETED 

BASIC-E PROGRAM 
INSTRUCTIONS FOR OTHELLO.BAS 
MICROSOFT BASIC PROGRAM 
MICROSOFT BASIC PROGRAM 
BASIC-E INTERPRETER 
BASIC-E INTERPRETER 
BASIC-E INTERPRETER 
MICROSOFT BASIC PROGRAM 
MICROSOFT BASIC PROGRAM 
MICROSOFT BASIC PROGRAM 
MICROSOFT BASIC PROGRAM 
DELETED 


TYPE OTHELLO.DOC 
KHKAKKKKK EKER ERE RKE RARER RRR RRR ER RRR RER ERE REREREREREREREREERERREEK 


KRRAKKKKAKEKEKEKRKEREKEKREREEREEREERKREKEEREEK EERE KEREKREKEKEKREEKKERKEEKKESE 
ak 


ak REKKK KEEKE * * KEKKK * * REKKK 
wk * * * * * * * * x * 
** * * * * * * * * * * 
°°. *x * * KEKKE KEK * * * * 
kk * * * * * * * * * * 
kk * * * * * * * * * * 
** RKEKK * * * REKKK REKKE RKKKE KKKKK 


** 
RRAEKKEKKEKEEEKKEKEKEKEKEREKRKRKKRERERRRE EERE EERE EREERKERRERKEKEKREKKEEEEKE 
KRRKKEKKKKKEREKRERREERERREREE EERE ERERERKREEEREREREREEKREREERRRERERE 


OTHELLO IS ONE OF THE MOST POPULAR GAMES AROUND TODAY. 
THE EXCITEMENT IS CERTAINLY JUSTIFIED, SINCE OTHELLO IS AN EXCELLENT 
GAME. OTHELLO SWEPT JAPAN AND IS NOW MAKING A COMMERCIAL SWEEP HERE. 
HOWEVER, THE BASIC CONCEPTS OF THE GAME HAVE BEEN AROUND SINCE THE 
VICTORIAN TIMES IN ENGLAND WHERE IT WAS CALLED REVERSI. 

THE GAME OTHELLO / REVERSI IS A VERY SIMPLE, ELEGANT ONE, 
WHICH PERMITS MUCH OPPORTUNITY FOR STRATEGY. THE GAME IS PLAYED ON AN 
8 BY 8 MATRIX, AND EACH PLAYER HAS 32 PLAYING DISKS, WHICH ARE WHITE 
ON ONE SIDE AND BLACK ON THE OTHER (REPRESENTED IN THE COMPUTER 
VERSION BY 'X' AND 'O' RESPECTIVELY). ONE PLAYER PLAYS 'O' (COMPUTER) 
AND THE OTHER PLAYS 'X' (HUMAN). FOUR STARTER PIECES ARE PLACED IN 
THE CENTER OF THE BOARD TO BEGIN PLAY (EXCEPT WHEN A HANDICAP IS 
GIVEN BY EITHER YOU OR THE COMPUTER. IN THIS CASE THE CORNER SPACES 
ARE GIVEN TO THE PERSON RECEIVING THE HANDICAP [ BUT BEWARE!!! THERE 
IS A 25% PROBABILITY THAT ANY ONE HANDICAP PIECE MAY BE PLACED 
RANDOMLY ON THE BOARD]. FOR EXAMPLE, IF YOU GIVE THE COMPUTER A 
HANDICAP OF 3 [WHICH WOULD BE DONE BY ENTERING A RANK OF 8, RANK 5 
IS DEAD EVEN] , THREE CORNERS WOULD BECOME'O''S AT THE START OF THE 
GAME.). EACH PLAYER IN TURN PLACES ONE DISC ON THE BOARD [BY ENTERING 
Y,X TO 'YOUR MOVE'] AND MUST OUTFLANK THE OPPOSITION BY SURROUNDING 
ONE OR MORE ROWS OF HIS OPPONENT'S DISCS [THERE CAN BE ONE DISK IN A 
ROW] WITH ONE OF HIS OWN. AFTER DOING SO THE ENTIRE ROW BECOMES HIS. 
THE WINNER IS THE PLAYER WITH THE MOST DISCS OF HIS COLOR ON THE 
BOARD WHEN ALL DISCS HAVE BEEN PLAYED. THE STRATEGY COMES IN PLANNING 
WHERE TO OUTFLANK TO GAIN THE MOST DISCS OR TO MANEUVER PIECES TO 
THE STRONGEST POWER POSITIONS ON THE BOARD. 


Kk 
ak 
ak 
ask 
*k 
ak 
ak 
ak 
ak 
ak 
kk 
Kk 
Kk 


THIS COMPUTER VERSION WAS DESIGNED NOT ONLY TO PLAY A REASONABLE 


GAME WITH A HUMAN OPPONENT, BUT ALSO TO AID IN PERFECTING OUR GAME. 


THE FOLLOWING LISTING WAS WRITTEN IN BASIC-E A DISK BASED MICROCOMPUTER 


LANGUAGE SUPPORTED BY IMSAI AND OTHERS. IT WILL RUN ON ANY CP/M BASED 
8080/Z280 SYSTEM. THE GAME IS AVAILABLE FROM THE MEMORY MERCHANTS ON 


DISK OR AS A NON-DISK VERSION FOR TDL'S EXTENDED BASIC. THE LISTING CAN 
BE MODIFIED TO SUIT MOST ANY BASIC BY DELETING THE DISK ACCESS ROUTINES, 


INCLUDING LINE NUMBERS AND SHORTENING SOME OF THE VARIABLE NAMES [BASIC 


-E IS FREE FORMATTED AND ONLY REQUIRES LINE NUMBERS FOR GOTO'S AND GOSUB 


‘S AND ALSO ALLOWS VARIABLE NAMES UP TO 3] CHARACTERS]. 

THIS VERSION HAS ELEVEN OPTIONS AVAILABLE TO THE USER. THEY 
ARE IMPLEMENTED BY RESPONDING TO 'YOUR MOVE' WITH A 0,# ,WHERE '#' 
IS A NUMBER FROM 0-10. COMMANDS 0,0 AND 0,5 ALLOW YOU TO SAVE THE 
CURRENT GAME ON THE DISK [0,5 SAVES IT WITH THE NAME DESIGNATED AT 
THE BEGINING OF THE GAME. 0,0 ALLOWS YOU TO CHANGE THE NAME OF THE 
DISK FILE]. IN THE EVENT YOU HAVE NO LEGAL MOVES, YOU MAY FORFEIT 
A MOVE AND LET YOUR OPPONENT TAKE AN EXTRA MOVE. THIS IS DONE BY 
THE COMMAND 0,1 [IF YOU USE THIS COMMAND AND THERE ARE LEGAL MOVES 
A LIST OF YOUR LEGAL MOVES WILL APPEAR]. COMMANDS 0,2 AND 0,3 ARE 
COMPLIMENTARY, COMMAND 0,3 EXCHANGES THE PIECES AND LETS YOU PLAY 
THE COMPUTERS CURRENT POSITION, AND, COMMAND 0,2 EXCHANGES THE 
PIECES BUT ALSO SWITCHES THE PLAY TO THE COMPUTER TO RETAIN THE 
PROPER CONTINUITY. COMMAND 0,4 ENDS THE GAME [FOR CHICKENS!1!]. 
COMMAND 0 6 PTTS THE COMPIITER AGATNST TTSELF [AUTO COMMAND]. 


COMMANDS 0,7 0,8 AND 0,9 ARE USED TO SET UP THE BOARD, MOVE A 
PIECE AND DELETE A PIECE RESPECTIVELY. TRY THEM THEY ARE SELF 
EXPLANATORY. FINALLY COMMAND 0,10 LISTS THE AVAILABLE COMMANDS IN CASE 


YOUR MEMORY BANK HAS A GLITCH. 
HAKKAKKARAKARAKAREAKEREREK COOD LUCK XR RRAKERKEAKAKKKKEKRARKEKERERERERK 


NOTE THAT ALTHOUGH MITCH HAS PUT COPYRIGHT NOTICES INTO THE PROGRAM 
SOURCE, HE IS PERMITTING UN-RESTRICTED HOBBIEST EXCHANGE. PLEASE 
LEAVE THE NAME AND ADDRESS OF THE ORIGINATOR IN THE FILE. A.R.G. 


c> 


POLY-vu 
#PVI19 


“SE 


D> CPMUG vol. 10 , 5/18/86 
-CATALOGO10 1K 
LLLBASICASM 85K 
LLLBASICCOM 7K 
LLLBASICDOC 4K 

LLLFP ASM 61K 

LLLMON ASM 5K 

PIP COM 7K 

TEST FIL 1K 

XDIR COM 2K 

9 file(s). 

47 directory entries remaining. 
D>STAT O: 


Bytes Remaining On O: 68k 


D> 
D>TYPE O:-CATALOG. 010 
VOLUME 10 


LAWRENCE LIVERMORE BASIC INTERFACED TO CP/M 
WITH DISK LOAD OF PROGRAMS 


THESE PROGRAMS REPLACE THE VERSIONS ISSUED ON 
CP/M USERS' GROUP VOLUME 2 
NUMBER SIZE NAME COMMENTS 
1K CATALOG.10 CONTENTS OF CP/M GROUP VOL 10 
4K LLLBASIC.DOC COMMENTS ON PROGRAMS IN VOLUME 10 
10.1 85K LLLBASIC.ASM SEE LLLBASIC.DOC 
10.2 7K LLLBASIC.COM TOTAL ASSEMBLED PACKAGE 
10.3 61K LLLFP.ASM SEE LLLBASIC.DOC 
10.4 5K LLLMON.ASM SEE LLLBASIC.DOC 
10.5 1K TEST.FIL TEST PROGRAM. TO RUN TYPE 


"LLLBASIC TEST.FIL" AND AFTER 
"READY" PROMPT, TYPE "PTAPE"™ 
THEN YOU MAY "LIST" OR "RUN® 


K&M Company 
TORRANCE, 6A 90503 


er 


TYPE O:LLLBASIC.DOC 
NOTES ON ORGANIZATION OF THIS LLLBASIC PACKAGE, 


J. I. FREDERICK 12/26/77 


THE ORGANIZATION IS DIFFERENT FROM BOTH THAT DESCRIBED IN THE JAN 77 

DR. DOBB'S AND THE SEPT. 77 COMPUTER. IN THIS ONE, THE LLL PROGRAMS ARE 
MOVED TO 0100H, FIXED LENGTH TABLES ARE INSERTED, THEN VARIABLE LENGTH 
TABLES AND FINALLY A MONITOR TO INTERFACE TO CP/M. 


THE VARIABLE LENGTH COMPONENTS ARE NOW ALL CONTAINED IN THE PACKAGE 
NAMED LLLMON. 

THE OBJECTIVE WAS TO PERMIT FUTURE MODS TO BE MADE WITHOUT 
REASSEMBLING LLLBASIC AND LLLFP. 


SUMMARY OF CHANGES FROM DR. DOBB'S: 


LLLBASIC 
1) EQUATES CHANGED TO MOVE IT TO LOW MEMORY 
2) JUMP INSERTED AT BEGINNING TO TRANSFER CONTROL TO 
INITIALIZATION ROUTINE IN LLLMON 
3) FWAM-WORD CONTAINING ADDRESS OF MEMST MOVED INTO LLLMON, 
4) EQUATE AT BEGINNING OF LLLBASIC CHANGED. 


LLLFP 
EQUATES CHANGED TO REFLECT NEW LOCATION 


USING THIS PACKAGE: 


1. START BY TYPING "LLLBASIC XXX.YYY" WHERE XXX.YYY IS A PREVIOUSLY 
EDITED SOURCE PROGRAM CREATED WITH ED.COM. BASIC EDITOR WILL 
OUTPUT "READY". (NOTE YOU MUST SPECIFY AN EXISTING FILE HERE, 
EVEN IF YOU DON'T WISH TO USE IT, SINCE THE INITIALIZATION 
ROUTINES CHECK IT OUT) 


2. IF YOU ARE GOING TO PUT IN A PROGRAM THROUGH THE CONSOLE, ENTER "SCR" 
TO CLEAR MEMORY. (SOME NEEDED HOUSEKEEPING IS NOT GETTING DONE). 


3. ENTER A BASIC PROGRAM THROUGH THE CONSOLE (WHICH CAN'T BE 
SAVED YET) OR TYPE "PTAPE" TO READ IN THE PROGRAM WHOSE NAME IS 
IN THE FCB. (I.E. THE XXX.YYY) 

4. CONTROL-C RETURNS TO CP/M. 

5. IN BASIC PROGRAM, CALL (1) RETURNS TO CP/M. THIS IS TO DEMONSTRATE 
USE OF ASSEMBLY SUBROUTINES. SEE "SUB1" IN LLLMON FOR THIS EXAMPLE. 


DIAGRAM OF MEMORY 


0100 tenner n nnn nnn nnn ene =~ 
I JMP INIT I 
I I 
0116 MIA I INTERPRETER I 
I I 
08D9 OUTR I CONSOLE OUTPUT ROUTINE I 
I (87D6 IN DR. DOBB'S) I 
I I 
0A96 INP I CONSOLE INPUT ROUTINE I 
I (8993H IN DR. DOBB'S) I 
I I 
TODD nnn nnn nnn nen enn ne 


I I a 
7 FLOATING POINT PACKAGE I LUG? 

I I 

I T 


etd 
1774 


17AD 


1800 


18AA 
1900 
1902 
1904 


1920 
1923 
1925 


MEMST 


VEND 


IOJUMP 


CODE BELOW --> 


POINT CAN BE REARRANGED AND EXPANDED BY REASSEMBLING LLLMON. 


2000 
D> 


MONEND 


I 3 BYTES NOT USED I 
I I 
I FPJUMP I 
I I 
I SLACK I 
I I 
I ACTIVE VARIABLES I 
I I 
I STACK ADDRESS I 
ai A(USER SUBRT TABLE) I 
I I 
I IOJUMP TABLE I 
Bs I 
I JUMP INITIALIZE I 
aE A(MONITOR END) I 


I a 
I TABLE OF POINTERS TO I 
I USER SUPPLIED SUBROUTINES I 
Ba I 


POLY-VU 
#PV119 


K&M Company 
TORRANCE. CA 90503 


‘S 


Oo 


-CATALOGOI1 
BASIC/5 ASM 
BASIC/5 COM 
BASIC/5 DOC 
PIP COM 
STARTREKTBI 
TINICOPYSUB 
TINIDISKASM 
TINIDISKCOM 
TINIDISKDOC 
VOLUME11D0C 
XDIR COM 
12 file(s). 


45 directory entries remaining. 


D STAT O: 


-CPMUG vol. 11- 


Bytes Remaining On O: 51k 


D TYPE -CATALOG.011 


VOLUME 11 


DISK TINIBASIC AND DISK PROCESSOR TECHNOLOGY BASIC/5 


NUMBER SIZE 


11.1 76K 
11.2 8K 

11.3 7K 

11.4 6K 

11.5 1K 

11.6 62K 
11.7 3K 

11.8 13K 
D 


NAME 


CATALOG.11 
VOLUME11.D0C 
BASIC/5.ASM 
BASIC/5.COM 
BASIC/5.DOC 


STARTREK.TBI 
TINICOPY.SUB 
TINIDISK.ASM 
TINIDISK.COM 
TINIDISK.DOC 


COMMENTS 


CONTENTS OF CP/M VOLUME 11 
COMMENTS ON CONTENTS 

PRO TECH 5K DISKIFIED BASIC 

5K BASIC IN 8K (SIGN OF THE TIMES) 
CP/M IMPLEMENTATION AND OTHER 
MAJOR EXTENSIONS EXPLAINED 

WAS ALSO #2.7 SEE VOLUME11.D0C 
SOMEONE USES THE SUBMIT PROGRAM?? 
SOURCE OF TINIDISK 

WAS ALSO #2.8 

WAS ALSO #2.9 


5/18/86: 


‘TYPE VOLUME11.D0C 
PROCESSOR TECHNOLOGY BASIC/5 (SOFTWARE #2) PATCHED 
FOR CP/M DISK SAVE AND LOAD AND FOR LPRINT AND LLIST 


*"This package is being made available, free of 
restrictions and cost .... to the individual hobbiest, 
clubs, schools, colleges and universities for their 
own computer systems. 

Any commercial use ...... is strictly forbidden 
without...permission of Processor Technology Corporation." 


*NOTICE INCLUDED IN SOURCE LISTING BOOKLET. ALSO AVAILABLE 
FROM PROCESSOR TECHNOLOGY IS "5K BASIC MANUAL" AS PRIMER TO 
BASIC IN GENERAL AND BASIC/5 SYNTAX IN PARTICULAR. SEE THESE 
TWO BOOKLETS PLUS THE BASIC/5.DOC FOR FULL UNDERSTANDING. a 


DISK TINIBASIC. THIS SOURCE LISTING IS ACCOMPANIED BY 
THE COM FILE, DOC FILE AND STARTREK.TBI PREVIOUSLY 

SEEN AS FILES 2.8,2.9 AND 2.7 RESPECTIVELY. NOTE THAT 
THE STARTREK LISTING APPARENTLY ENDS IN MID-SUBROUTINE. 
THE PROGRAM APPEARS TO RUN, ALTHOUGH A REAL TREKKY WILL 
PROBABLY EXERCISE THE FATAL PORTION AND WARP HIMSELF OUT 
OF THE TPA. wI BET KLINGONS SPEAK IN ZILOG MNEMONICS 


TYPE BASIC/ 54 DOC 
HAMPSHIRE COLLEGE BASIC VERSION 21.0 


PROCESSOR TECHNOLOGY 5K BASIC, ADAPTED FOR CP/M 
BY KEVIN JORDAN (BOX 588, HAMPSHIRE COLLEGE, AMHERST, MASS. 01002). 


WITH MODIFICATIONS BY JEFF ZURKOW. 


THIS IS PROC. TECH. 5K BASIC MODIFIED TO START AT 100H AND 
TO DO ITS I/O THROUGH CP/M. PROVISIONS HAVE BEEN ADDED TO 
ALLOW BASIC PROGRAMS TO BE SAVED AS CP/M FILES, OPERATION 
MADE FASTER FOR LARGE~MEMORY SYSTEMS, AND A NUMBER OF 

NEW STATEMENTS AND COMMANDS HAVE BEEN ADDED. 


CONTROL CHARACTERS 


RUBOUT AND CTRL-U WORK AS IN CP/M. 
CTRL-C TAKES YOU BACK TO THE COMMAND LEVEL OF BASIC/5. 
CTRL-E AND CTRL-P ARE NOT IMPLEMENTED. 


TO GET BACK TO CP/M, USE THE COMMAND "SYSTEM". 


DISK FILES 


IN THE COMMANDS THAT FOLLOW, <FN> DENOTES A FILE NAME OF UP TO 8 CHARACTERS, 
OPTIONALLY FOLLOWED BY A DOT (".") AND A FILE TYPE OF UP TO THREE 
CHARACTERS. IF THE FILE TYPE IS OMITTED, IT DEFAULTS TO "BSC". IF NAME AND 
TYPE ARE BOTH OMITTED, THE DEFAULT IS "PROGRAM.BSC". AS A SPECIAL CASE, THE 
QUERIES "NEW PROGRAM NAME" AND "OLD PROGRAM NAME" MAY BE ANSWERED WITH A 
CARRIAGE RETURN ALONE, OR WITH A FILE NAME AND NO TYPE, TO TAKE ADVANTAGE OF 
THE DEFAULT OPTIONS. 


THE FILE COMMANDS ARE: 


NAME TYPES THE CURRENT WORKSPACE NAME. 

NAME <FN> RENAMES THE CURRENT WORKSPACE TO THE SPECIFIED NAME AND TYPE. 

NEW <FN> RENAMES THE CURRENT WORKSPACE AND ERASES THE PROGRAM. 

OLD <FN> ERASES THE CURRENT PROGRAM AND LOADS THE SPECIFIED FILE FROM 
a DISK. IF <FN> IS OMITTED, "OLD" (AND "NEW") WILL ASK FOR 

UNSAVE <FN> ERASES THE SPECIFIED FILE FROM THE DISK. 

ERA <FN> SAME AS UNSAVE <FN>. 

SAVE SAVES THE CURRENT PROGRAM ON THE DISK UNDER THE CURRENT 


WORKSPACE NAME. IF A FILE WITH THIS NAME ALREADY EXISTS, IT) 
IS DELETED FIRST. gis 


SAVE <FN> RENAMES THE WORKSPACE TO <FN> AND THEN DOES A SAVE, 


IF A FILE IS SPECIFIED WHEN BASIC IS INVOKED (IE. "BASIC/5 <FN>"), IT WILL BE 
LOADED AND BASIC WILL REFRAIN FROM ASKING "NEW OR OLD?". NOTE THAT FILES 
SAVED BY BASIC ARE IN AN INTERNAL FORMAT, NOT ASCII, SO THEY CANNOT BE 

EDITED WITH THE CP/M EDITOR. 


OTHER NEW COMMANDS: 


SYSTEM RETURNS CONTROL TO CP/M WITH REBOOT. 

LLIST SYNTAX IS SAME AS NORMAL "LIST", BUT LISTS ON CP/M LIST DEVIC! 
INSTEAD OF ON CONSOLE. LISTING IS PRECEEDED AND FOLLOWED BY 
2 CRLF'S. 


THE FOLLOWING STATEMENTS HAVE BEEN ADDED: 


WHERE BYTE VALUES ARE INDICATED, AN ARBITRARY EXPRESSION, EVALUATING TO A 
BYTE VALUE (8-BIT INTEGER) MAY BE USED. EXPRESSIONS EVALUATING TO 16-BIT 
INTEGERS MAY SIMILARLY BE USED FOR ADDRESS VALUES. 


OUT <PORT>[<B1>,<B2>, . . . ,<BN>] 


THE BYTES Bl, B2, . . . ,BN ARE OUTPUT TO THE SPECIFIED PORT. 
AN INDEFINITE NUMBER OF ADDITIONAL PORTS AND BYTE STRINGS MAY BE SPECIFIED, 
PRECEEDED BY COMMAS. EXAMPLE: OUT 2[27,109],5[44,10] 


POKE <Al>[<B1>,<B2>, . . . ,<BN>] 


PUTS THE BYTES Bl .. . BN IN MEMORY STARTING AT LOCATION <Al> (A 16-BIT 
VALUE). THE RIGHT BRACKET MAY BE FOLLOWED BY A COMMA AND ANOTHER ADDRESS 
AND BYTE STRING, AND SO ON. 


PUSH <Al>,<A2>, . . . ,<AND> 


THE ADDRESSES (16-BIT INTEGERS) <Al> THROUGH <AN> ARE PUSHED ON AN INTERNAL 
STACK WHICH BUILDS DOWNWARD FROM LOCATION "MACSTK" IN THE SOURCE TEXT. THERE 
IS CURRENTLY ROOM FOR 17 ENTRIES, AND STACK OVERFLOW CHECKING IS PROVIDED. 
THE LAST ADDRESS IN THE LIST WINDS UP ON THE STACK TOP (IE. IT WILL BE THE 
FIRST ENTRY REMOVED). "PUSH", AND THE CORRESPONDING "POP" ARE INTENDED TO 
PROVIDE A WAY OF PASSING MULTIPLE ARGUMENTS TO MACHINE-LANGUAGE SUBPROGRAMS, 


(2 
abe 


TRAP <Al>,;<AZ>, « « « 2 <AND 


THIS STATEMENT BEHAVES LIKE "PUSH", BUT REFERENCES A SEPARATE STACK. 
THE VALUES PUSHED ARE TREATED AS LINE NUMBERS. WHEN AN ERROR OCCURS 
IN BASIC, THE TOP VALUE WILL BE POPPED OFF THE TRAP STACK AND CONTROL 
WILL PASS TO THE STATEMENT IT SPECIFIES. IF THE STACK IS EMPTY, AN 
ERROR MESSAGE WILL BE PRINTED AS USUAL. 


INPUT "<STRING>", <VAR. LIST> 


THE QUOTED STRING IS OPTIONAL. IF INCLUDED, IT WILL BE PRINTED AS A PROMPT, 
IN PLACE OF THE QUESTION MARK THAT "INPUT" NORMALLY TYPES. OTHERWISE, THE 
SYNTAX IS IDENTICAL TO NORMAL "INPUT" STATEMENT. 


LPRINT 


THIS HAS THE SAME SYNTAX AS THE NORMAL "PRINT" STATEMENT, BUT 
OUTPUT GOES TO THE CP/M LIST DEVICE INSTEAD OF TO THE CONSOLE. 


BEAM X,Y 
DRAW X,Y 


THESE STATEMENTS ARE FOR USE WITH TEKTRONIX 4010-SERIES GRAPHICS TERMINALS. 
"BEAM" PUTS THE TERMINAL IN GRAPH MODE AND POSITIONS THE BEAM TO SCREEN 
COORDINATES X,Y. "DRAW" MOVES THE BEAM FROM ITS CURRENT LOCATION TO NEW 
LOCATION X,Y, DRAWING A LINE AS IT GOES. xX AND Y MUST BE EXPRESSIONS 
EVALUATING TO 10-BIT INTEGERS, ALTHOUGH THE INTERPRETER ONLY CHECKS TO MAKE 
SURE THEY ARE VALID 16-BIT INTEGERS. 


OUTPUT TO THE TEKTRONIX TERMINAL IS NOT THROUGH CP/M (FOR SPEED), BUT RATHER 
THROUGH A SEPARATE HARDWARE DRIVER IN THE BASIC INTERPRETER. THE DRIVER 
ROUTINE IS NAMED "TPUT" IN THE SOURCE PROGRAM, AND IS CURRENTLY CONFIGURED 
FOR AN IMSAI SIO BOARD WITH THE TERMINAL ON PORTS 3 AND 2. 


NEW AND MODIFIED INTRINSIC FUNCTIONS: 


INP (N) RETURNS VALUE READ FROM PORT N, WHERE N IS A BYTE VALUE. 

PEEK (N) RETURNS BYTE FROM MEMORY LOCATION N, WHERE N IS A 16-BIT 
INTEGER. 

POP (N) POPS N VALUES OFF THE STACK WHERE THEY WERE PUT BY "PUSH", 
AND RETURNS THE NTH OF THESE AS ITS VALUE. THE OTHERS ARE 
LOST. 

UNTRAP (N) LIKE "POP", BUT TAKES VALUES OFF TRAP STACK. 

ARG (N) ARGUMENT MUST BE 16-BIT INTEGER. ARG RETURNS ITS ARGUMENT of 
AS ITS VALUE, BUT ALSO SAVES IT FOR USE BY "CALL". NOT gl 


MODIFIED BUT NESCRTRED HERE FOR THE SAKF OF COMPLETENESS. 


CALL (N) 


D> 


LOADS REGISTER PAIR BC WITH THE VALUE MOST RECENTLY PASSED 
BY "ARG", AND EXECUTES A MACHINE-LANGUAGE "CALL" TO LOCATION 
N. IN ADDITION, REGISTER PAIR DE IS LOADED WITH A POINTER TO 
THE TOP OF THE "PUSH" STACK, FROM WHICH PREVIOUSLY "PUSH"ED 
VALUES CAN BE RETRIEVED. 


THE MACHINE-LANGUAGE ROUTINE CAN RETURN A 16-BIT VALUE BY 
PLACING ITS LOW BYTE IN A AND HIGH BYTE IN B. THIS VALUE IS 
CONVERTED TO FLOATING~POINT AND RETURNED AS THE VALUE OF THE 
BASIC "CALL". THE ARGUMENT STACK POINTER IS NOT PASSED BACK 
TO BASIC. 


PARAMETER PASSING IN THE CALL STATEMENT NOW CONFORMS TO PL/M 
CONVENTIONS. 


e2iPO Lawl JLOK. DUC 
SHERRY BROTHERS TINY BASIC VERSION 3.1 


THIS IS A COPY OF LICHEN WANG'S 'PALO ALTO TINY BASIC' WHICH HAS BEEN 
MODIFIED TO INCLUUDE MORE FUNCTIONS, AND DISK SAVE AND LOAD. 
IT SETS IT'S SIZE TO WHATEVER SIZE YOUR SYSTEM IS, SO IT DOES NOT NEED 
TO BE REASSEMBLED FOR DIFFERENT SYSTEM SIZES. 
IF YOU HAVE ANY PROBLEMS WITH IT GIVE ME A CALL OR WRITE ME AND I WILL 
SEE WHAT I CAN DO. HERE IS MY ADDRESS AND PHONE: 

BRUCE SHERRY 

1054 BLUEBELL DR. 

LIVERMORE, CA. 94550 

TEL (415) 44349288 


THE LANGUAGE 
NUMBERS 


IN TINY BASIC, ALL NUMBERS ARE INTEGERS AND MUST BE LESS THAN 32767. 
VARIABLES 


THERE ARE 26 VARIABLES DENOTED BY LETTERS A THROUGH Z. THERE IS ALSO A 
SINGLE ARRAY @(I). THE DIMENSION OF THIS ARRAY (I.E., THE RANGE OF 
VALUE OF THE INDEX I) IS SET AUTOMATICALLY TO MAKE USE OF ALL THE 

MEMORY SPACE THAT IS LEFT UNUSED BY THE PROGRA. (I.E., 0 THROUGH SIZE/2, 
SEE SIZE FINCTION BELOW.) 


FINCTIONS 


PRESENTLY THERE ARE 6 FUNCTIONS: 
ABS(X) GIVES THE ABSOLUTE VALUE OF X. 
% RND(X) GIVES A RANDOM NUMBER BETWEEN 1 AND X (INCLUSIVE). 
— SIZE GIVES THE NUMBER OF BYTES LEFT UNUSED BY THE PROGRAM. 
IT IS A TWO'S COMPLEMENT NUMBER SO IF IT IS 
NEGATIVE IT IS ACTUALLY LARGER THAN 32767. 
INP(X) GIVES THE VALUE (0 TO 255) OF INPUT PORT X 
PEEK(X) GIVES THE VALUE OF MEMORY LOCATION X. TWO'S COMPLEMENT 
AGAIN. 
USR(X<,Y>) CALLS THE MACHINE LANGUAGE SUBROUTINE AT LOCATION X. 
OPTIONAL PARAMETER Y IS PASSED IN H&L IF THERE AND THE 
VALUE OF THE FUNCTION IS RETURNED IN H&L. THE PROGRAM 
SAVES ALL REGISTERS, SO YOU DON'T HAVE TO. 


ARITHMETIC AND COMPARE OPERATORS 


/ DIVIDE. NOTE THAT SINCE WE HAVE INTEGERS ONLY, 2/3=0. 

* MULTIPLY. 

= SUBTRACT. 

+ ADD. 

> COMPARE IF GREATER THAN. 

< COMPARE IF LESS THAN. 

= COMPARE IF EQUAL TO. NOTE THAT TO CERTAIN VERSIONS OF 
BASIC "LET A=B=0" MEANS "SET BOTH A AND B TO 0". TO 
THIS VERSION OF TINY BASIC, IT MEAND "SET A TO THE 
RESULT OF COMPARING B WITH 0". 

# COMPARE IF NOT EQUAL TO. 

>= COMPARE IF GREATER THAN OR EQUAL TO. 

<= COMPARE IF LESS THAN OR EQUAL TO. 


+, -, *, AND / OPERATIONS RESULT IN A VALUE OF BETWEEN -32767 AND 
32767. (-32768 IS ALSO ALLOWED IN SOME CASES.) ALL COMPARE OPERATORS 
RESULT IN A 1 IF TRUE AND A 0 IF NOT TRUE. 


EXPRESSIONS 


EXPRESSIONS ARE FORMED WITH NUMBERS, VARIABLES, AND FUNCTIONS WITH 
ARITHMETIC AND COMPARE OPERATORS BETWEEN THEM. + AND - SIGNS CAN ALSO 
BE USED AT THE BEGINNING OF AN EXPRESSION. THE VALUE OF AN 

EXPRESSION IS EVALUATED FROM LEFT TO RIGHT, EXCEPT THAT * AND / ARE 
ALWAYS DONE FIRST, AND THEN + AND - , AND THEN COMPARE OPERATORS. 
PARENTHESES CAN ALSO BE USED TO ALTER THE ORDER OF EVALUATION. 


STATEMENTS 


A TINY BASIC STATEMENT CONSISTS OF A STATEMENT NUMBER BETWEEN 1 AND 

32767 FOLLOWED BY ONE OR MORE COMMANDS. COMMANDS IN THE SAME STATEMENT 
ARE SEPARATED BY A SEMI-COLON ";". "GOTO", "STOP", AND "RETURN" COMMANDS 
MUST BE THE LAST COMMAND IN ANY GIVEN STATEMENT. 


PROGRAM 


A TINY BASIC PROGRAM CONSISTS OF ONE OR MORE STATEMENTS. WHEN A DIRECT 
COMMAND "RUN" IS ISSUED, THE STATEMENT WITH THE LOWEST STATEMENT NUMBER 
IS EXECUTED FORST, THE THE ONE WITH THE NEXT LOWEST STATEMENT NUMBER, ETC. 
HOWEVER, THE "GOTO", "GOSUB", "STOP", AND "RETURN" COMMANDS CAN ALTER 
THIS NORMAL SEQUENCE. WITHIN THE STATEMENT, EXECUTION OF COMMANDS IS 
FROM LEFT TO RIGHT. THE "IF" COMMAND CAN CAUSE THE EXECUTION OF ALL THE 
COMMANDS TO ITS RIGHT IN THE SAME STATEMENT TO BE SKIPPED OVER. 


COMMANDS 

TINY BASIC COMMANDS ARE LISTED BELOW WITH EXAMPLES. REMEMBER THAT 
COMMANDS CAN BE CONCATENATED WITH SEMI-COLONS. IN ORDER TO STORE THE 
STATEMENT, YOU MUST ALSO HAVE A STATEMENT NUMBER IN FRONT OF THE 
COMMANDS. THE STATEMENT NUMBER AND THE CONCATENATION ARE NOT SHOWN 

IN THE EXAMPLES. 

REM OR REMARK COMMAND 

REM ANYTHING GOES 

THIS LINE WILL BE IGNORED BY TBI. 

LET COMMAND 

LET A=234-5*6, A=A/2, X=A-100, @(X+9)=A-1 

WILL SET THE VARIABLE A TO THE VALUE OF THE EXPRESSION 234-5*6 (I.E. 204), 
SET THE VARIABLE A (AGAIN) TO THE VALUE OF THE EXPRESSION A/2 (I.E. 102), 
SET THE VARIABLE X TO THE VALUE OF THE EXPRESSION A=100 (I.E. 2), AND 
THEN SET THE VARIABLE @(11) TO 101 (WHERE 11 IS THE VALUE OF THE 
EXPRESSION AX+9 AND 101 IS THE VALUE OF THE EXPRESSION A~-1). 

LET U=A#B, V=(A>B) *X+(A<B) *Y 

WILL SET THE VARIABLE U TO EITHER 1 OR 0 DEPENDING ON WHETHER A IS NOT 
EQUAL TO OR IS EQUAL TO B; AND SET THE VARIABLE V TO EITHER X, Y OR 0 
DEPENDING ON WHETHER A IS GREATER THAN, LESS THAN, OR EQUAL TO B. 
PRINT COMMAND 

PRINT 


WILL CAUSE A CARRIAGE-RETURN (CR) AND A LINE-FEED (LF) ON THE OUTPUT 
DEVICE. 


PRINT A*3+1, "ABC 123 1!@#", ' CBA ! 


goe 
WILL PRINT THE VALUE OF THE EXPRESSION A*3+1 (I.E. 307), THE STRING aor 
OF CHARACTERS "ABC 123 1@#" AND THR STRING" CRA " AND THEN A 


CR-LF. NOTE THAT EITHER SINGLE OR DOUBLE QUOTES CAN BE USED TO QUOTE 
STRINGS, BUT PAIRS MUST BE MATCHED. 


PRINT A*3+1, "ABC 123 !@#", ' CBA ', 


WILL PRODUCE THE SAME OUTPUT AS BEFORE, EXCEPT THAT THERE IS NO CR-LF 
AFTER THE LAST ITEM IS PRINTED, THIS ENABLES THE PROGRAM TO CONTINUE 
PRINTING ON THE SAME LINE WITH ANOTHER "PRINT", 


PRINT A, B, #3, C, D, E, #10, F, G 


WILL PRINT THE VALUES OF A AND B IN 6 SPACES, THE VALUES OF C, D, AND 
E IN 3 SPACES, AND THE VALUES OF A AND G IN 10 SPACES. IF THERE ARE 
NOT ENOUGH SPACES SPECIFIED FOR A GIVEN VALUE TO BE PRINTED, THE VALUE 
WILL BE PRINTED WITH ENOUGH SPACES ANYWAY. 


PRINT 'ABC',_,'XXX'! 


WILL PRINT THE STRING "ABC", A CR WITHOUT A LF, AND THEN THE STRING 
"XXX" (OVER THE ABC) FOLLOWED BY A CR-LF. 


INPUT COMMAND 


INPUT A, B 


WHEN THES COMMAND IS EXECUTED, TINY BASIC WILL PRINT "A:" AND WAIT TO 
READ IN AN EXPRESSION FROM THE INPUT DEVICE. THE VARIABLE A WILL BE 
SET TO THE VALUE OF THES EXPRESSION. THEN "B:" IS PRINTED AND VARIABLE 
B IS SET TO THE VALUE OF THE NEXT EXPRESSION READ FROM THE INPUT DEVICE. 
NOTE THAT NOT ONLY NUMBERS, BUT ALSO EXPRESSIONS CAN BE READ AS INPUT. 


INPUT 'WHAT IS THE WEIGHT'A, "AND SIZE"B 

THIS IS THE SAVE AS THE COMMAND ABOVE, EXCEPT THE PROMPT "A:" IS REPLACED 
BY "WHAT IS THE WEIGHT:" AND THE PROMPT "B:" IS REPLACED WITH "AND 
SIZE:". AGAIN, BOTH SINGLE AND DOUBLE QUOTES CAN BE USED AS LONG AS 

THEY ARE MATCHED. 


INPUT A, 'STRING',_, "ANOTHER STRING", B 

THE SRINGS AND THE "_" HAVE THE SAVE EFFECT AS IN "PRINT", 

OUT COMMAND 

OUT 2, A+5, 6, B/7 

WILL CAUSE THE LEAST SIGNIFICANT BYTE OF THE EXPRISSION "A+5" TO BE 
OUTPUT TO PORT 2, AND THEN THE LEAST SIGNIFICANT BYTE OF THE EXPRESSION 
"B/7" WILL BE OUTPUT TO PORT 6. 


OUT X+Y,Z 


THIS OUTPUTS THE VALUE OF Z (L.S. BYTE) TO THE PORT SPECIFIED BY THE 
EXPRESSION "X+yY" 


WAIT COMMAND 
WAIT I,J 


THIS READS THE STATUS OF PORT "I" AND MASKS THIS WITH "J" BY WAY OF A 
"LOGICAL AND", IT WILL CONTINUE READING UNTIL THE RESULT OF THE "AND" 
IS NOT EQUAL TO ZERO. 


WAIT I,J,K at 


q 
THIS IS THE SAME AS BEFORE EXCEPT THAT THE STATUS IS LOGICALLY EXCLUSIVE a 
OR'ED WITH "K" BEFORE THE MASK TO INVERT BITS IF NECCESSARY 


POKE COMMAND 
POKE 4000+X,Y 


THIS COMMAND WORKS JUST LIKE OUT, EXCEPT THAT EXPRESSION "Y" IS WRITTEN 
INTO MEMORY LOCATION SPECIFIED BY THE EXPRESSION "4000+X". 


IF COMMAND 
IF A<B LET X=3; PRINT 'THIS STRING' 


WILL THES THE VALUE OF THE EXPRESSION A<B. IF IT IS NOT ZERO (I.E. IF IT 
IS TRUE), THE COMMANDS IN THE REST OF THIS STATEMENT WILL BE EXECUTED. 

IF THE VALUE OF THE EXPRESSION IS ZERO (I.E. IF IT IS NOT TRUE), THE REST 
OF THIS STATEMENT WILL BE SKIPPED OVER AND EXECUTION CONTINUES AT THE 
NEXT STATEMENT. NOTE THAT THE WORD "THEN" IS NOT USED. 


GOTO COMMAND 

GOTO 120 

WILL CAUSE THE EXECUTION TO JUMP TO STATEMENT 120. NOTE THAT "GOTO" 
COMMAND CANNOT BE FOLLOWED BY A SEMI-COLON AND OTHER COMMANDS. 

IT MUST BE ENDED WITH A CR. 

GOTO A*10+B 


WILL CAUSE THE EXECUTION TO JUMP TO A DIFFERENT STATEMENT NUMBER AS 
COMPUTED FROM THE VALUE OF THE EXPRESSION. 


GOSUB AND RETURN COMMANDS 

GOSUB 120 

WILL CAUSE THE EXECUTION TO JUMP TO STATEMENT 120. 
GOSUB A*10+B 


WILL CAUSE THE EXECUTION TO JUMP TO DIFFERENT STATEMENTS AS COMPUTED 
FROM THE VALUE OF THE EXPRESSION A*10+B. 


RETURN 


A RETURN COMMAND MUST BE THE LAST COMMAND IN A STATEMENT AND BE FOLLOWED 
BY A CR. WHEN A RETURN COMMAND IS ENCOUNTERED, IT WILL CAUSE THE EXECUTION 
TO JUMP BACK TO THE COMMAND FOLLOWING THE MOST RECENT GOSUB COMMAND. 


GOSUB CAN BE NESTED. THE DEPTH OF NESTING IS LIMITED ONLY BY THE STACK 
SPACE. 


FOR AND NEXT COMMANDS 
FOR X=A+1 TO 3*B STEP C-1 


THE VARIABLE X IS SET TO THE VALUE OF THE EXPRESSION Atl. THE VALUES OF 
THE EXPRESSIONS (NOT THE EXPRESSIONS THEMSELVES) 3*B AND C-1 ARE REM- 
BERED. THE NAME OF THE VARIABLE X, THE STATEMENT NUMBER AND THE 
POSITION OF THIS COMMAND WITHIN THE STATEMENT ARE ALSO REMEMBERED. 
EXECUTION THEN CONTINUES THE NORMAL WAY UNTIL A NEXT COMMAND IS 
ENCOUNTERED. 


THE STEP CAN BE POSITIVE, NEGATIVE OR EVEN ZERO. THE WORD STEP AND THE 


\ 
EXPRESSION FOLLOWING IT CAN BE OMITTED IF THE DESIRED STEP IS +1. 


ye 
D- 
ca 4 
NEXT X 


THE NAME OF THE VARIABLE (X) IS CHECKED WITH THAT OF THE MOST RECENT FOR 
COMMAND. IF THEY DO NOT AGREE, THAT FOR IS TERMINATED AND THE NEXT RECENT 
FOR IS CHECKED, ETC. WHEN A MATCH IS FOUND, THIS VARIABLE WILL BE SET TO 
ITS CURRENT VALUE PLUS THE VALUE OF THE STEP EXPRESSION SAVED BY THE FOR 
COMMAND. THE UPDATED VALUE IS THEN COMPARED WITH THE VALUE OF THE TO 
EXPRESSION ALSO SAVED BY THE FOR COMMAND. IF THIS WITHIN THE LIMIT, 
EXECUTION WILL JUMP BACK TO THE COMMAND FOLLOWING THE FOR COMMAND. IF 
THIS IS OUTSIDE THE LIMIT, EXECUTION CONTINUES FOLLOWING THE NEXT COMMAND 
ITSELF. 


FOR CAN BE NEXTED. THE DEPTH OF NESTING IS LINITED ONLY BY THE STACK 
SPACE. IF A NEW FOR COMMAND WITH THE SAME CONTROL VARIABLE AS THAT OF AN 
OLD FOR COMMAND IS ENCOUNTERED, THE OLD FOR WILL BE TERMINATED AUTOMATIC- 
ALLY. 

STOP COMMAND 

STOP 

THIS COMMAND STOPS THE EXECUTION OF THE PROGRAM AND RETURNS CONTROL TO 
DIRECT COMMANDS FROM THE INPUT DEVICE. IT CAN APPEAR MANY TIMES IN A 
PROGRAM BUT MUST BE THE LAST COMMAND IN ANY GIVEN STATEMENT. I.E. IT 
CANNOT BE FOLLOWED BY A SEMI-COLON AND OTHER COMMANDS, 


DIRECT COMMANDS 


AS DEFINED EARLIER, A STATEMENT CONSISTS OF A STATEMENT NUMBER FOLLWOED 
BY COMMANDS. IF THE STATEMENT NUMBER IS MISSING, OR IF IT IS 0, THE 
COMMANDS WILL BE EXECUTED AFTER YOU HAVE YPED THE CR. ALL THE COMMANDS 
DESCRIBED ABOVE CAN BE USED AS DIRECT COMMANDS. THERE ARE SIX MORE 
COMMANDS THAT CAN BE USED AS DIRECT COMMANDS BUT NOT AS PART OF A 
STATEMENT. 

RUN 


WILL START TO EXECUTE THE PROGRAM STARTING AT THE LOWEST STATEMENT 
NUMBER. 


LIST 
WILL PRINT OUT ALL THE STATEMENTS IN NUMERICAL ORDER. 
LIST 120 


WILL PRINT OUT ALL THE STATEMENTS IN NUMERICAL ORDER STARTING AT 
STATEMENT 120. 


NEW 
WILL DELETE ALL THE STATEMENTS. 

SAVE STARTREK 

WILL SAVE THE PRESENT PROGRAM ON DISK BY WAY OF THE CPM OPERATING 
SYSTEM. IT WILL BE SAVED AS A FILE NAMED "STARTREK.TBI", THIS 

IS NOT A PURE ASCII FILE AS THE LINE NUMBERS ARE STORED IN BINARY. 
LOAD STARTREK , 


WILL DELETE ANY PROGRAM IN MEMORY AND WILL LOAD IN A FILE FROM DISK 
CALLED "STARTREK.TBI", IF IT EXISTS. 


BYE x 


WILL RETURN YOU TO THE CPM OPRFRATTING SYSTEM, 


STOPPING THE EXECUTION 


THE EXECUTION OF PROGRAM OR LISTION OF PROGRAM CAN BE STOPPED BY THE 
CONTROL-C KEY ON THE INPUT DEVICE. 


ABBREVIATION AND BLANKS 


YOU MAY USE BLANKS FREELY, EXCEPT THAT NUMBERS, COMMAND KEY WORDS, AND 
FUNCTION NAMES CANNOT HAVE EMBEDDED BLANKS. 


YOU CAN TRUNCATE ALL COMMAND KEY WORDS AND FUNCTION NAMES AND FOLLOW 
EACH BY A PERIOD. "PR.", "PRI.", "PRIN." ALL STAND FOR "PRINT", 
ALSO THE WORD LET IN LET COMMANDS MAY BE OMITTED. THE "SHORTEST" 
ABBREVIATION FOR ALL THE KEY WORDS ARE AS FOLLOWS: 


A.=ABS F.=FOR GOS. =GOSUB G.=GOTO 
IF=IF I.=INP IN.=INPUT L.=LIST 
LO.=LOAD N.=NEW N.=NEXT O.=OUTPUT 
P.=PEEK P.=POKE PR.=PRINT REM=REMARK 
R.=RETURN R.=RND R.=RUN S.=SAVE 
S.=SIZE S.=STEP S.=STOP TO=TO 
U.=USR W.=WAIT 


NULL AND NONE-OF-THE-ABOVE = LET 

ERROR REPORT 

THERE ARE ONLY THREE ERROR CONDITIONS IN TINY BASIC. THE STATEMENT WITH 
THE ERROR IS PRINTED OUT WITH A QUESTION MARK INSERTED AT THE POINT 
WHERE THE ERROR IS DETECTED. 


(1) WHAT? MEANS IT DOES NOT UNDERSTAND YOU. EXAMPLE: 


WHAT? 

260 LET A=B+3, C=(3+4?. X=4 

HOW? 

210 P?TINT "THIS" WHERE PRINT IS MISSTYPED 


(2) HOW? MEANS IT UNDERSTANDS YOU BUT DOES NOT KNOW HOW TO DO I. 


HOW? 

310 LET A=B*C?+2 WHERE B*C IS LARGER THAN 32767 
HOW? 

380 GOTO 412? WHERE 412 DOES NOT EXIST 


(3) SORRY? MEANS IT UNDERSTANDS YOU AND KNOWS HOW TO DO IT BUT THERE 
IS NOT ENOUGH MEMORY TO DO IT. 


ERROR CORRECTIONS 


IF YOU NOTICE AN ERROR IN TYPEIN BEFORE YOU HIT THE CR, YOU CAN DELETE 
THE LAST CHARACTER BY THE RUB-OUT KEY OR DELETE THE ENTIRE LINE BY THE 
"\" KEY. TINY BASIC WILL ECHO A BACK ARROW "_" FOR EACH RUB-OUT. 

ECHO FOR BACK-SLASH CONSISTS OF A LF, A CR, AND AN UP ARROW. 


TO CORRECT A STATEMENT, YOU CAN RETYPE THE STATEMENT NUMBER AND THE 


CORRECT COMMANDS. TINY BASIC WILL TRPLACE THE OLD STATEMENT WITH THE NEW 
ONE. 


TO DELETE A STATEMENT, TYPE THE STATEMENT NUMBER AND A CR ONLY. 


VERIVY THE CORRECTIONS BY "LIST NNNN" AND HIT THE CONTROL-C KEY WHILE AY 
THE LINE IS BEING PRINTED. nw 

\o 
D> 


POLY-vu 
#PVI19 


K&M Company 
TORRANCK.CA 90503 


er} 


Oo 


-CATALOGO13 
15/PUZ ASC 
1500 ASC 


23MATCH BAS 
BAGELS BAS 
BIORYME ASC 
BLACKJACBAS 
BULLSEYEBAS 
CHECKERSBAS 


- CHIEF BAS 


CONVERT BAS 
DICE BAS 
KINGDOM BAS 


LUNAR COM 
NFL BAS 
ROCKET BAS 


RUSSIAN BAS 
SWARMS BAS 
SWARMS2 ASC 
TRAP BAS 
WUMPAS' BAS 
ZOSO 2 

22 file(s). 


CPMUG vol. 13 | 


41 directory entries remaining. 


D>STAT O: 


Bytes Remaining On O: 101k 


D> 


2/11/86 


TYPE O:-CATALOG, 013 
VOLUME 13 


BASIC-E/CBASIC AND MICROSOFT BASIC PROGRAMS 


A VERY MIXED BUNCH. ZOSO LAMENTS ABOUT THE 
QUALITY IN HIS CHRISTMAS PLAY, COMPLETE WITH GREEK 
CHORUS. THIS DISKETTE IS A MUST FOR ANYONE WHO 
MUST HAVE A COPY OF EVERYTHING. UNFORTUNATELY 

A FEW JEWELS HERE MAY BE MISSED BECAUSE OF THE 
COMPANY IT KEEPS IN THIS VOLUME 


THE *.ASC ARE MICROSOFT, THE *.BAS WILL (SOMETIMES) 
COMPILE ON BASIC-E/CBASIC. MANY ARE COMPATIBLE. ALL 
CAN BE SWITCHED WITH SYNTACTICAL SYNCHRONIZATION (WHO 
SAID THAT??) (MY LIPS DIDN'T MOVE) 


NUMBER SIZE NAME COMMENTS 

CATALOG £13 CONTENTS OF CP/M VOLUME 13 
13.1 7K 15/PUZ.ASC PROGRAM IN MICROSOFT BASIC 
13.2 7K 1500.ASC PROGRAM IN MICROSOFT BASIC 
13.3 2K 23MATCH.BAS PROGRAM IN BASIC-E/CBASIC 
13.4 3K BAGELS.BAS PROGRAM IN BASIC-E/CBASIC 
13.5 4K BIORYME.ASC PROGRAM IN MICROSOFT BASIC 
13.6 6K BLACKJAC.BAS PROGRAM IN BASIC-E/CBASIC 
13.7 1K BULLSEYE.BAS PROGRAM IN BASIC-E/CBASIC 
13.8 6K CHECKERS .BAS PROGRAM IN BASIC-E/CBASIC 
13.9 2K CHIEF.BAS PROGRAM IN BASIC-E/CBASIC 
13.10 2K CONVERT. BAS PROGRAM IN BASIC-E/CBASIC 
13.11 7K DICE.BAS PROGRAM IN BASIC-E/CBASIC 
13.12 7K KINGDOM.BAS PROGRAM IN BASIC-E/CBASIC 
13.13 DELETED 
13.14 15K NFL.BAS PROGRAM IN BASIC-E/CBASIC 
13.15 4k ROCKET.BAS PROGRAM IN BASIC-E/CBASIC 
13.16 1K RUSSIAN. BAS PROGRAM IN BASIC-E/CBASIC 
13.17 16K SWARMS .BAS PROGRAM IN BASIC-E/CBASIC 
13.18 16K SWARMS2.ASC PROGRAM IN MICROSOFT BASIC 
13.19 2K TRAP .BAS PROGRAM IN BASIC-E/CBASIC 
13.20 6K WUMPAS.BAS PROGRAM IN BASIC-E/CBASIC 
13.21 23K Z0SO.2 WHEN THE REVIEW IS ABOUT TWICE AS 


LONG AS ANY OF THE PROGRAMS, I GUESS 
THE REVIEWER HAS SOMETHING ON HER/HIS 
MIND 


D> 


TYPE O2Z2U5U. 4 (Cr™uy vir #5} 


ZOSO'S HOLIDAY VISIT 


SINCE LAST WE MET, I HAVE GROWN GLOOMY. IT IS CERTAIN THAT MY LIFE 
S A BASIC-E ARCHIVIST PRESENTS [THANKS TO YOU] THE SAME REWARDS AND CHALLENGES 
AS THOSE THAT CAN BE DERIVED FROM TOLL-COLLECTION [AFTER YOU PASS THE CIVIL- 


SERVICE EXAM]. 


TONY TELLS ME THAT SOME OF YOU WITH TTY'S HAVE COMPLAINED THAT MY 
MAUNDERINGS TAKE TOO LONG TO PRINT. FOR THOSE OF YOU WHO USE SUCH DEVICES 
AS A CONSOLE, WE COULD HAVE HAD A NICE DEBATE FIVE YEARS AGO. I DON'T MEAN 
TO ACT OVERLY SENSITIVE TO CRITICISM, BUT UNLESS YOU TTY PEOPLE ARE WRITING 
THIS SLANDER FROM THE BOWELS OF AN AIRCRAFT CARRIER, AND THE DATE ON YOUR 
CRUDELY LIMNED POISON-PEN LETTERS IS PRIOR TO 'VE DAY' THEN ALL I CAN SAY 
IS, "MAY YOU LEARN TO 'SPEED-READ' AT 10-C.P.S.". 


THE MERE MENTION OF THIS HAS SO UPSET ME, THAT I SHALL HAVE TO DIGRESS 
FURTHER... ONE COMPUTER-CLUB MEETING WAS TOO MUCH FOR ME... ALL THOSE 'GEEKS' 
ARGUING RELATIVE MERITS OF THEIR RESPECTIVE SYSTEMS (HARDWARE AND SOFTWARE). 
T'M NOT A PAID ADVERTISER, SO WHAT THE HELL... I LIKE THE 2-80... SOFTWARE IS 
QUITE ANOTHER ISSUE; I HAVE EXHAUSTIVELY EXAMINED ALL THE 'BASICS' AVAILABLE 
FOR THE 8080//2-80, AT PRESENT. IN THIS AREA, I HAVE SOME FIRM [AND PERHAPS 
HELPFUL] OPINIONS WHICH I WISH TO SHARE... (DON'T ARGUE; I OWE YOU NOTHING) ! 


THERE ARE ONLY THREE REALLY GOOD BASICS FOR THESE PROCESSORS (S-100 BUS ONLY): 


1 - MITS/MICROSOFT 
2 - TDL 
3 - BASIC-E//C-BASIC 


6.; IS NO ACCIDENT THAT I LISTED THEM IN THIS ORDER. IF ANY OF YOU HAVE SEEN OR 
USED TDL'S 12K BASIC, I'M SURE YOU WISH (AS I DO) THAT THEY HAD ISSUED A CP/M 
DISK BASIC. MICROSOFT DISK BASIC IS [THOUGH NOT PERFECT] BY FAR THE 'STATE OF 
THE ART’. FOR THOSE OF YOU WHO RUN SUCH EXCELLENT SOFTWARE ON ALTAIR DISKS, IT 
IS RUMORED THAT THE VOLTAGE MINISTER FROM THE UGANDAN-REPUBLIC WILL VISIT YOUR 
VERY TOWN, AND OFFER YOU BIG BUCKS FOR YOUR EQUIPMENT... YOU SEE, THEY NEED 
MACHINERY LIKE YOURS TO MAINTAIN THEIR S--T LISTS, (AND YOU MUST KNOW WHY)... 


THE MAIN ISSUE I WANTED TO RAISE WAS: HOW DO I STAND ON BASIC-E...? 


I HAVE WRITTEN A SHORT DRAMA FOR YOU, IN WHICH I PLAY MYSELF... AND FOR YOU 
SOFTWARE PIRATES; I ONLY STOLE MR. DICKENS' TITLE, NOT HIS ENTIRE WORK. 


Peer Sresessesasss 


DRAMATIS PERSONAE: 


BE: ADVOCATE OF BASIC-E -~ AND HIS RETINUE OF 'WRONGOS' 

ZO: YOUR HUMBLE REVIEWER -- WONDER WHY THE ALIAS ? 

AN: ANNOUNCER -- SO FAR, AN HONEST JOURNEYMAN 

CH: THE CHORUS ~- FROM THOSE QUAALUDE-LIKE GREEK PLAYS 


ACT I 


BE: BASIC-E IS A COMPILER. 
ZO: I SEE; BUT THERE ARE OINTMENTS TO RELIEVE THAT. 


gosut 


BE: YOU CAN 'SECURE' YOUR PROGRAMS BY ONLY GIVING A CLIENT THE ‘INT' FILE OF 


ZO: 


BE: 


ZO: 


YOUR PatrnuLL UK WHATEVER. 

NO DOUBT YOU WILL BE ABLE TO SELL YOUR PAYROLL PROGRAM TO SOME ESKIMO IN 
POINT BARROW ALASKA, WHOSE 100 EMPLOYEES SELL FREEZERS. OF COURSE EACH 
TIME HE NEEDS A MINOR CHANGE TO THE 'INT' FILE YOU GAVE HIM, YOU CAN 
DISPATCH YOUR HELICOPTER WITH A FRESHLY COMPILED VERSION. IN MOST CASES 
SMALL BUSINESSES ARE TOO CONCERNED WITH THEIR REGULAR AFFAIRS TO RIP- 
OFF YOUR PROGRAM; ADDITIONALLY, SOME INDIVIDUALS HAVE MADE REMARKABLE 
PROGRESS IN 'SECURING' PROGRAMS WRITTEN FOR INTERPRETER BASICS. 


(*) - << !!! URGENT BULLETIN - CHECK UPDATE BELOW !!! >> 


BASIC-E IS MORE MEMORY EFFICIENT. 
TRUE, BUT TIME IS MONEY, AND MEMORY IS GETTING CHEAP. 


BASIC-E IS A PUBLIC-DOMAIN ITEM. ANYONE CAN IMPROVE IT FOR THE BENEFIT 

OF ALL OF US. 

GET US OUR SHOVELS ! 

YOU'RE RIGHT! THAT IS WHY THERE ARE SO MANY TOTALLY INCOMPATIBLE VERSIONS 
FLOATING AROUND NOW. DID YOU KNOW THAT ONE VENDOR HAS SEPARATE RUN PACKAGES 
FOR DISK AND NON-DISK FILES? IF THE AUTHOR OF BASIC-E OFFERED IT FOR THE 
"GOOD OF THE COMPUTER COMMUNITY", WHY HAVE SO MANY DIFFERENT PEOPLE TAKEN 
IT UPON THEMSELVES TO FIX ONE OR TWO MINOR 'BUGS'’ AND THEN RELEASED SUCH 
ENHANCEMENTS AS PROPRIETARY PROJECTS, WORTH THE [FILL IN THE BLANK] DOL- 
LARS, YOU PAID FOR THEM. THE LATEST [$100.00] VERSION PROVED TO ME, BEYOND 
ANY DOUBT, THAT BY THE TIME BASIC~E IS PERFECTED, ITS ADHERENTS WILL HAVE 
PAID LIKE A DRUG ADDICT FOR THEIR PARTICULAR SENSE OF PARTICIPATION, AND 
WILL HAVE 'MISSED THE BOAT' IN THE INTERIM. 


THERE ARE MORE ERROR MESSAGES (PROGRAM DIAGNOSTICS) IN BASIC-E. IT'S EASIER 
TO GET MY SECOND [OH SURE !] TRY RIGHT. 
UH-HUH... I REMEMBER THE WAY THAT WORKS. HERE'S AN EXAMPLE: 
100:IF NOT TM<>DC THEN GY=GY+YOUR.BUCKS 

CH a [HONEST, THEY LOOK LIKE THIS] ! 
HOW OBVIOUS...!! 'TM' IS YOUR LADY'S 'TIME-OF-MONTH'. 'DC' IS THE MINOR 
SURGERY SHE NEEDS [<IF LAST.TM+ABS(LAST.TM+(28*3)) LE NEW.TM>] SIMPLE, EH? 
OF COURSE, 'GY' IS THE 'SURGEON' IN THE DRAMA, AND 'YOUR.BUCKS' IS THE 
REASON YOU GOT A 'CH' ERROR... DIG OUT YOUR MANUAL (IF YOU EVEN HAVE THE 
LATEST ONE), AND YOU WILL SEE THAT 'CH' IS THE 'CAN'T HAPPEN' ERROR WHICH 
IS CERTAINLY TRUE, SINCE YOUR LADY HAS NOT LET YOU TOUCH HER FOR THE LAST 
TWO YEARS... 


WE CAN USE LONG SIGNIFICANT VARIABLE NAMES TO MAKE OUR SOURCE CODE MORE 
READABLE; FOR EXAMPLE: 

TAKEHOME. PAY=HOURLY. RATE. PAY+OVERTIME. PAY+XMAS.BONUS-TAXES.WITHELD 

IT DOES LOOK GOOD ON THOSE SOUPED UP CRT'S WITH HALF-INTENSITY, REVERSE 
VIDEO ETC. BUT WHATS WRONG WITH: TP=HR+OP+XB-TW ? I HAVE FOUND NO SPECIAL 
HARDSHIP IN USING THE 2 CHARACTER VARIABLE NOR ANY SPECIAL BENEFIT IN 
USING THE LONGER ONES... ALSO THE INTERPRETER BASICS I MENTIONED HAVE A 
[HARDCOPY/PAPER EFFICIENT] TRACE MODE. EVEN THE MOST LOGICALLY CONVOLUTED 
PROGRAMS CAN EASILY BE SO UNENTANGLED; THOSE PRETENSIONS [ OF BASIC-E ] 
ARE ONLY USEFUL IF THE PROGRAMMER CAN MAINTAIN THE SEMBLANCE OF AN EIGHTH 
GRADE EDUCATION WHEN GIVEN THE 'POWER' OF LONG VARIABLE NAMES... YOU WOULD 
SUFFOCATE IN SELF-DOUBT IF YOU SAW HOW OFTEN SUCH AN ENHANCEMENT WAS USED 
THUSLY: 'ON ENTPRIZE.FUEL+LOSTIME.SPC.WRPS* (INT(SPOCK)) GO TO...' FACE THIS 
FACT OF LIFE!!! SOME CAN SPELL; AND SOME CAN PROGRAM. NEVER, (WELL ALMOST 
NEVER), THE TWAIN SHALL MEET... 


: WELL THERE REALLY ARE A LOT! MORE SPECIFIC ERROR MESSAGES. 


YES, I'M ESPECIALLY FOND OF THE 'NP’ ('NO SUCH ANIMAL') ONE... BUT I REALLY 
DISLIKE THE WAY IN WHICH ANY RUN-TIME ERRORS RETURN ME TO CP/M COMMAND 
LEVEL (AS DO THOSE ERROR TRAPS WHICH YOU HAVEN'T BOTHERED TO WRITE !). 


I PERSONALLY PREFER PREPARING PROGRAMS WITH A TEXT EDITOR. THE 'MACRO' 
COMMAND IS REALLY POWERFUL. 

YOU HORSE'S [BODY PART], IF YOU USE AN INTERPRETER BASIC WITH 'ASCII-SAVE', 
YOU CAN USE THE TEXT EDITOR OR THE [BETTER] BASIC'S LINE EDITOR, WHICH 


I FEEL 18S A FAR MORE POTENT TUOL. THE BESY UL BULA Wil wb 2 LYU Whi soos 


CH: WE SEE THE CROCODILE TEARS WELLING IN THE EYES OF THAT SENSITIVE YOUNG 
‘ARTISTE', BE:... 


AN: 'THE STARS BELONG TO EVERYONE, THE BEST THINGS IN LIFE ARE FREE...’ 
CH: YES, AND YOU CATCH YOU KNOW WHAT FROM PUBLIC W.C.'S; JUST ASK GRANDPA... 


ACT II 


ZO: PERHAPS I WAS A BIT HARSH ON HIM. I THINK I'LL HAVE A FEW BEERS, AND 
ENROLL IN CHARM SCHOOL TOMORROW. I NEVER DID GET TO POINT OUT THAT TO 
CORRECT A SINGLE 'TYPO' IN A LARGE BASIC-E SOURCE CAN CONSUME THE BETTER 
PART OF TWENTY MINUTES AND THAT'S ABOUT 100 TIMES SLOWER THAN DOING THE 
SAME THING WITH THOSE INTERPRETER BASICS [WHICH I PREFER]. 


CH: MEANWHILE IN A TINY ATTIC OF A RATTY OLD HOUSE, DOWNWIND FROM THE SMOKE- 
STACKS OF A LARGE PESTICIDE FACTORY... SLOW THINKING FOLKS, WITH ACCENTS 
ONE IS HARD-PRESSED NOT TO LAUGH AT; SEXUAL HANG-UPS GALORE; A WRETCHED 
ENVIRONMENT FROM WHICH ONLY THE MOST GIFTED ESCAPE... (SORRY, BE:) 


BE: HEAVENS TO BETSY ! MY 34K STARTREK IS PERFECT, EXCEPT IT SIGNS ON AS, 
"STARDREK'... I'LL HAVE TO GO BACK TO THE EDITOR AND THEN THE COMPILER, 
I'M GOING CRAZY... 


A SHORT WHILE LATER... 


AN: AND SO 'BE:', A NOVICE PROGRAMMER, WAS ARRESTED BY GOVERNMENT AGENTS FOR 
ALLEGEDLY EXPOSING HIMSELF TO THE [UNIDENTIFIED] ESTRANGED WIFE OF CANADA'S 
PRIME MINISTER [I DREAM ABOUT YOU A LOT M.T., HEH, HEH...]. 


CH: DON'T LET IT HAPPEN TO YOU... 
o EPILOGUE 


ZO: THE ORIGINAL AUTHOR(S) OF BASIC-E ARE DESERVING OF PRAISE FOR HAVING 
RELEASED A GOOD PRODUCT TO THE PUBLIC. THERE ARE SOME PEOPLE WHO HAVE 
WRITTEN WONDERFUL AND WELL DOCUMENTED MATERIAL IN BASIC-E. THE ABOVE- 
MENTIONED ARE ASSURED THAT I SPECIFICALLY EXEMPT THEM FROM ANYTHING 
OF A CRITICAL NATURE THAT I MAY HAVE SAID. I ONLY LAMENT THE FACT THAT 
TOO MANY PEOPLE HAVE GONE TOO MANY DIFFERENT WAYS WITH BASIC/E, AND 
WHEN CODE IS LAZILY PREPARED (FOR BASIC/E), IT BECOMES UNWIELDY AS 
ONE COULD EVER, EVER IMAGINE. 


(*) IMPORTANT BULLETIN !1!! IT HAS BEEN WIDELY REPORTED THAT SOME GULLIBLE 
HOBBYISTS HAVE BEEN 'EUCHRED' INTO PURCHASING ABSOLUTELY WORTHLESS 
‘INT' FILES OF PROGRAMS FOR WHICH THEY SINCERELY FELT THE SOURCE WAS 
FOR SALE. IF YOU ARE NOT PROMISED THE ORIGINAL & ENTIRE SOURCE IN 
WRITING, PAY NOT CENT-ONE FOR ANYTHING YOU MAY SEE ADVERTISED IN EITHER 
BASIC-E, OR C-BASIC. BY THIS, I MEAN SPECIFICALLY THAT YOU [FEW] HYPER- 
SECRETIVE SORTS WHO DARE CHARGE FOR RAW MACHINE-CODE [UNLESS SO ADVERTISED, 
AND I MEAN EXPLICITLY] WILL HAVE ABOUT 60 DAYS BEFORE YOUR BUSINESS CON- 
FORMS TO REALITY, OR WORD-OF-MOUTH [PERHAPS MINE] KILLS IT. 


FINIS 


NOW UNDERSTAND THIS PLEASE, I ONLY DO 'PASSION-PLAYS' FOR THE 
HOLIDAYS. 


ee ee ee eee eae eee com Se come ee ee ee ee ane se ee cee me ce omer cee ey ses mes es hese es ee mary ee ee ce ses ee ae ee cee ee en se ee ee ee Ot eee 
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AND NOW ON TO THE SOFTWARE REVIEW... 


wy 
BIORYME.BAS 


a 


APPEARS TU BE A Siw: WA!) virvsiALYN CAVTADIS YO atk UU naeiN I ANNs vr Lbs 
LITTLE MONSTERS... THERE APPEARS TO BE SOME LINES SUGGESTING INPUT/OUTPUT. 
MIGHT BE INTERFACEABLE TO A CONSOLE OR LIST DEVICE. THIS IS NOT THAT WONDERFUL 
IMPROVEMENT YOU MIGHT HAVE BEEN EXPECTING. WOE BE UNTO THOSE WHO TRY TO FEED 
THIS TO ANY OF YOUR COMPILER-BASICS; [TRY MITS BASIC... IF YOU MUST]. 

(P.S. THIS APPEARS TO BE A MITS BASIC PROGRAM AFTER FAULTY 

RECOVERY THROUGH A LIST32 PROGRAM OF SOME ILK. AFTER ADDING 


 # ) A FEW MISSING PARENTHESES, THIS PROGRAM PERFORMS QUITE WELL 


AS A MICROSOFT [I.E. TYPE.ASC] PROGRAM AND HAS BEEN RE- 
NAMED AS SUCH. SHAME ON ZOSO FOR NOT PERSEVERING!!! A.R.G) 
SHAME ON ZOSO, INDEED !!! RUN THIS TURKEY AND DECIDE FOR YOURSELVES !!! 2. 


BAGELS3.BAS 
IF YOU RECALL, LAST TIME THERE WERE TWO VERSIONS OF THIS GAME, AND I REALLY 
LIKED THEM BOTH. SAME APPLIES HERE!!! KEEP ALL THREE VERSIONS! USE THEM ALL! 


THEY ARE ALL GOOD, AND EACH HAS ITS OWN SPECIAL 'STYLE'. REALLY GOOD !! 


BLACKJAC.BAS 

I HAVE MIXED FEELINGS ABOUT THIS ONE. IT IS AN EXCELLENT!!!! BLACKJACK 
SIMULATOR, HOWEVER THE GRAPHIC OUTPUT IS AWKWARD AND CONFUSING. TIED 

FOR WINNER THIS TIME AROUND. WHY DOESN'T SOMEONE GET THIS TO 'PRETTY-PRINT' 
AND SEND IT TO TONY. 


DICE.BAS 

THIS IS A VERY GOOD CRAPS SIMULATOR. THE IDENTICAL COMMENTS APPLY TO THIS 
AS TO BLACKJAC.BAS EXCEPT THIS ONE ISN'T TIED FOR WINNER. SEND THOSE 
GRAPHIC UPGRADES TO TONY. 


ROCKET.BAS [NAMED SOMETHING ELSE FOR LAST RELEASE] 

YOU'VE SEEN THIS BEFORE, BELIEVE ME ! THIS ISN'T AS GOOD AS THE EARLIER ONE 
(FROM FIRST DISTRIBUTION), AND FURTHERMORE IT EXHIBITS THE ALARMING TREND 

OF BEING ACCEPTABLE ONLY TO CERTAIN SPECIAL COMPILER/RUN VERSIONS. SELL THIS, 


oe THEN SELL THE PURCHASER THE EARLIER ONE AS A COSTLY UPGRADE. 


4 


A 


a 


CONVERT. BAS 
THE SUSPENSE IS OVER !! THIS IS THE CO-WINNER. THIS ALLOWS C-BASIC USERS TO 
TAKE A FULLY LINE-NUMBERED PROGRAM, AND GET RID OF ALL THE UNNECESSARY LINE 
NUMBERS. AS YOU C-BASIC SORTS MAY HAVE INFERRED, I AM NOT REALLY YOUR MOST 
ARDENT DISCIPLE; YET THIS IS A POWERFUL SOFTWARE ITEM FOR YOU, IT WORKS, 
AND IT IS CLEVER ! 
(P.S. DON'T BOTHER TO TRY IT ON A BASIC-E SET OF COMPILER AND 
RUN-TIME INTERPRETER. IN FACT, SINCE C-BASIC DOES'T ACTUALLY 
OBJECT TO EXTRA LINE NUMBERS, WHY TRY IT AT ALL???. A.R.G) 
ANSWER - TO FURTHER OBFUSCATE PROGRAMS WRITTEN IN THAT LANGUAGE... 2. 


WUMPAS.BAS 

LAST TIME ROUND I URGED THE GUILLOTINING OF THE PERPETRATOR OF SOME PROGRAM 
CALLED WUMPUS.BAS... TO THE CONTRIBUTER: IF IT LOOKS LIKE A DOG, SMELLS LIKE 
A DOG AND BARKS LIKE A DOG...WHAT NEXT ? WUMPIS.BAS, WUMPOS.BAS...OH GOD !1! 
DON'T ANYONE DARE SEND ME ANY WUMPES.BAS EITHER. THIS DOES HAVE ONE MAJOR 
ENHANCEMENT OVER THE LAST 'WUMPUS' I DIDN'T LIKE: THIS ONE DOESN'T WORK RIGHT. 
A GOOD PROJECT FOR THE TIME YOU HAVE TO SPEND IN RENO WAITING FOR YOUR DIVORCE 
TO FINALLY HAPPEN. 


KINGDOM.BAS 

I'VE TRIED THIS COMPILER-SENSITIVE ITEM A FEW TIMES. MERCIFULLY THE GAMES 
HAVE BEEN SHORT. YOU HOLD TOTAL SWAY OVER [LOYAL] SUBJECTS, ALLOCATE YOUR 
RESOURCES, AND DECIDE HOW TO BEST SPEND THE COIN OF THE REALM, 'RALLODS', 
[FIGURE THAT ONE OUT YOU CRYPTOGRAPHIC-WHIZZES]. THE APPARENT MASTERY OF THIS 
GAME INVOLVES EMBEZ2ZLING ALL THE 'RALLODS' YOU CAN, AND ALLOWING ALL OF YOUR 
SUBJECTS TO PERISH BEFORE THEY CAN DISCOVER YOUR AVARICE. 


SWARMS. BAS 

THE ATTACK OF THE KILLER BEES... GET ME MY HEART MEDICINE... I GROW FAINT...!1! 
THIS ONE DIDN'T WORK EITHER, BUT IT LOOKED LIKE IT MIGHT BE GOOD, SO I REWROTE 
IT A BIT FOR MICROSOFT DISK BASIC. MAYBE. IF YOU SEE A FILE SWARMS2.ASC, I'LL 


HAVE DECIDED TU INCLUDE IT. THIS 15 A VERY!! COMPKEHENSIVE GAME WITH A LUT OF 
OPTIONS. IT QUICKLY BECOMES CONFUSING AND BORING !!! THE PSYCHOLOGISTS 
AMONGST YOU WILL FIND THIS GAME A MOST INTERESTING DIAGNOSTIC TOOL!! WHEN I GOT 
THIS ONE RUNNING, ABOUT A DOZEN PEOPLE TRIED IT... EVERY SINGLE ONE, BY THE 
SECOND ATTEMPT, DID NOTHING BUT ‘NUKE’ UNEVACUATED AMERICAN CITIES, MYSELF IN- 
CLUDED. I THINK, IN FAIRNESS, HUMAN NATURE IS LESS AT FAULT THAN THIS MONUMENT 
TO FUTILITY... REMEMBER THAT PINBALL MACHINE WHICH YIELDED A FREE GAME EVERY 
QzHousann TRIES...? THIS GAME OFFERS THE SAME LIKELIHOOD OF VICTORY AS THAT 
VERY SAME MACHINE WITH ONLY 2 BALLS AND INOPERATIVE FLIPPERS... THE 'STING' ? 


RUSSIAN.BAS 

WHEN WILL YOU PARENTAL TYPES LEARN... UNLESS YOU TEACH YOUR 'RETARDATE' TO 
SIGN HIS PROGRAMS WITH SOMETHING CUTE LIKE 'LITTLE JOHNNY DOE AGE 7 1/2', 
SOMEBODY MAY MISTAKENLY THINK THAT YOU SUBMITTED THEM. YOU WOULDN'T WANT 

THAT TO HAPPEN, WOULD YOU ? FOR THE RECORD, THIS IS RUSSIAN-ROULETTE: THE ONE 
YOU'VE ALWAYS AVOIDED. THE OUTPUT OF THIS OPUS-MAGNUS CONSISTS OF THE WORDS, 
"CLICK' AND 'POW',. THE LATTER INDICATES THAT YOUR BRAINS HAVE BEEN SPATTERED 
ACROSS THAT PAYROLL PROGRAM YOU WERE PREPARING FOR THE ESKIMO FREEZER SALESMAN. 
I AM WRITING THIS A WEEK BEFORE CHRISTMAS, BUT I CANNOT REFRAIN FROM WISHING 
THAT THE AUTHOR HAD DEBUGGED THIS ITEM WITH A [REAL] .357 MAGNUM. BY THE WAY, 
IF YOU MUST PLAY THIS (AND I EARNESTLY HOPE YOU DON'T), YOU WILL MOST LIKELY BE 
RISKING YOUR LIFE WITH A SINGLE-SHOT ANTIQUE OR A SEVEN SHOT 'HYBRID' GUN. IT 
SEEMS THAT THE CALL TO RND (RANDOM-NUMBER) SEVERELY AFFECTS THE OTHER MISTAKES 
IN THIS PROGRAM. I'M NEW AT THIS BUSINESS, BUT I HOPE TO GAIN YOUR CONFIDENCE 
BY CALLING THEM AS I SEE THEM,... THIS IS THE VERY WORST PROGRAM THAT I HAVE 
EVER SEEN !!! I HAVE NEVER ELIMINATED ALL COPIES OF A FILE FROM MY ARCHIVES 
BEFORE. THIS TIME, I JUST MIGHT...CLICK-CLICK-POW !!! 


TRAP.BAS 

THE OBJECT OF THIS GAME IS TO TRAP A [RANDOM] NUMBER FROM 1 TO 100 BETWEEN 
TWO ADJOINING NUMBERS IN SIX OR LESS TRYS. FOR EXAMPLE, IF THE SECRET NUMBER 
IS 46 THEN THE WINNING 'MOVE' WOULD BE: 45,47. THIS GAME IS SIMPLE, BUT AN 
ONEST EFFORT WHICH IS FUN TO PLAY. ALSO, IT COMPILED WITHOUT ERRORS WHICH 
AKES IT A 'RARA AVIS' FOR THIS GROUP OF PROGRAMS. 


CHECKERS .BAS 
THIS PLAYS CHECKERS MINUS THE MULTIPLE JUMPS. IT'S A NICE PROGRAM, WELL WRITTEN 
ETC... THIS ONE COULD ALSO USE A GRAPHIC TOUCH-UP (SEND 'EM TO TONY). 


CHIEF.BAS 
REMEMBER THIS...? YOU THINK OF A NUMBER, PERFORM SOME DUMB ARITHMETIC, AND YOU 
ARRIVE AT ANOTHER NUMBER, WHICH YOU REVEAL TO THE CRASHING BORE WHO'S DOING 
THIS TO YOU, AND THAT PERSON WILL DEDUCE THE NUMBER YOU STARTED WITH...; WELL 
SOMEONE HAS COMPUTERIZED IT ALL AND BLAMED THE POOR INDIANS. I MUST CONFESS 
THAT I REFUSED TO RUN THIS OFTEN ENOUGH TO DETERMINE IF IT WORKS OR NOT. THE 
GAME(?) ENDS WITH A BIG LIGHTNING BOLT!! PERHAPS IT WOULD BE BEST FOR SOMEONE 
TO REMOVE THE ARITHMETIC AND THE INDIAN CHIEF, THEN TO TAKE WHAT'S LEFT AND 
RENAME IT 'LITENING.BAS',... BE HONEST, ANONYMOUS AUTHOR, ARE WE EXPECTED TO 
USE ANY NUMBER OTHER THAN 22 ONCE WE MASTER THE TRIBAL RULES ? 

(P.S. I TRIED IT, AND IT DOES WORK. NOT SURE THAT YOU NATIVE 

AMERICANS WILL APPRECIATE THE STEREOTYPE. I HEAR THAT THIS WAS 

THE MAJOR FUNDING PROJECT BY B.I.A. IN 1977. A.R.G) 


23MATCH.BAS 

THIS ONE PLAYS '23-MATCH NIM’. YOU ALWAYS GO FIRST. THE SLY COMPUTER ALWAYS 

GOES SECOND. GUESS WHO (OR WHAT) WINS... YAWN ! 
(P.S. I DIDN'T EXPERIENCE ZOSO'S PROBLEM, AND FOUND I COULD BEAT 
THE MACHINE 10 TIMES OUT OF TEN. FOR YOU MATHS TYPES, THE CORRECT 

Oo STRATEGY IS TO LEAVE THE MACHINE TO DEAL WITH A QUANTITY ONE 

GREATER THAT A MULTIPLE OF FOUR - IE START BY TAKING TWO AND 
LEAVING 21 (5*4+1). A.R.G) 


NFL.BAS 
y* AFTER SOME CONSIDERABLE 'TWEAKING', I GOT THIS ONE TO RUN. THIS IS WHAT I GOT; 
vy BN NFL FOOTBALL SIMULATOR. THIS IS HOW IT WORKS... 1) ONE TEAM KICKS OFF. 
2) IT'S 'HALFTIME' (YOU'VE GOT TO SEE THIS !!!). 3) THE OTHER TEAM KICKS OFF 


(AN 'ON-SIDES’ KICK AT THAT,. a2. THE oAAB _5S Us SR. osteo WER 21K a-UN WAR Jit 
BACK, THE SCORE IS (CORRECTLY) REPORTED AS A 0-0 TIE. MAYBE THIS WON'T ANNOY 
SOME OF YOU, BUT IT SURE AS HELL MAKES IT HARD TO ESTABLISH A POINT SPREAD. 


BULLSEYE.BAS 
EXAMINE THE SOURCE CODE... 
WITH ANY EXISTING COMPUTER LANGUAGE, 


IF ANY AMONGST YOU GET THIS ONE TO WORK (AS IS) 
YOU ARE NO DOUBT THE 'MESSIAH' SO MANY 


Oiave AWAITED. RECALL MY COMMENTS IN-RE 'RUSSIAN ROULETTE'. DILUTE THAT SEN- 


TIMENT BY 1/10 OF 1 PERCENT, SO AS TO SPARE ME WRITING MORE ABOUT SUCH TRIVIA. 
(P.S. LOOKS LIKE WE'VE LOST MOST OF THE SOURCE OF THIS ONE. CAN 
ANYONE LET US SEE WHAT'S MISSING? A.R.G.) 


D> 


POLY-vu 
#PV119 


K&M Company 
TORRANCE, CA 90503 


er) 


o 


-CATALOG017 
3DTICTACASM 
CROROS ASM 
DENVBAS ASM 
DISASM COM 
DISPLAY ASM 
FUNCTIONASM 
MINOL ASM 
NUMS ASM 
PROCCALCASM 
SPACE ASM 
VOLUME17DOC 
Z80-OPS ASM 
13 file(s). 


46 directory entries remaining. 


D>STAT O: 


CPMUG vol. 17 2/11/86 


Bytes Remaining On O: 73k 


D>TYPE O:-CATALOG.017 


VOLUME 17 


UTILITIES, DENVER TINY BASIC AND NON-BASIC GAMES 


NUMBER’ SIZE 


17.4 13K 
17.2 50K 
17.3 16K 
17.4 6K 

17.5 6K 

17.6 6K 

17.7 14K 
17.8 2K 

17.9 25K 
17.10 19K 
17.11 7K 

D> 


NAME 


CATALOG.17 
VOLUME17.DOC 
3DTICTAC.ASM 
CROROS.ASM 


DENVBAS.ASM 
DISASM.COM 
DISPLAY .ASM 
FUNCTION.ASM 
MINOL.ASM 


NUMS.ASM 
PROCCALC.ASM 


SPACE.ASM 
Z80-OPS.ASM 


COMMENTS 


CONTENTS OF CP/M GROUP VOL 17 
COMMENTS ON CERTAIN PROGRAMS 

GAME NOT YET PATCHED TO CP/M 
CROMEMCO RESIDENT OPERATING SYSTEM 
SEE VOL.DOC 

DENVER TINY BASIC FROM DR. DOBBS 
NO CP/M I/O YET 

REVISION OF INTEL DISASSEMBLER 
SEE VOL.DOC 

PART OF SPACE GAME. SEE VOL.DOC 
PART OF SPACE GAME. SEE VOL.DOC 
CORRECTED VERSION OF A TINY BASIC 
FROM DR. DOBBS 

PART OF SPACE GAME. SEE VOL.DOC 


PRO TECH DESK CALCULATOR PACKAGE. SEE 


VOL.DOC 
PART OF SPACE GAME. SEE VOL.DOC 


Z-80 MNEMONICS RECOGNIZED BY ASMX 16.1 


TYPE O:VOLUME17.DOC 
DENVBAS.ASM -- THIS IS DENVER TINY BASIC FROM DR. DOBB'S. IT CONTAINS 


NO CP/M I/O. 


Z80-OPS.ASM -- THESE ARE ALL OF THE MNEMONICS RECOGNIZED BY THE ASSEMBLER 
"ASMX.COM' 16.1 


MINOL.ASM -- THIS IS A TINY BASIC FROM DR. DOBB'S. IT CONTAINS 
NO CP/M I/O. NUMEROUS ERRORS IN THE ORIGINAL LISTING HAVE 
BEEN CORRECTED. 


SPACE.ASM, FUNCTION.ASM, DISPLAY.ASM, NUMS.ASM -- THESE ARE THE SPACE 
WAR PROGRAM FROM BYTE MAGAZINE, OCTOBER 1977. THEY ARE ALMOST 
ALL MACROS, SO MUST BE ASSEMBLED WITH MACASM 16.8 


CROROS.ASM -- THIS IS THE FAIRLY RECENTLY RELEASED CROMEMCO 
RESIDENT OPERATING SYSTEM (ROS). IT IS OBVIOUSLY AN EXTENSION 
OF THE PROC-TECH PACKAGE NO. 1. THEY HAVE MODIFIED THE 
ASSEMBLER IN IT TO ACCEPT Z80 MNEMONICS OF THE TYPE USED 
BY ZILOG (AS CONTRASTED WITH THE TDL MNEMONICS). THIS SOURCE 
IS A DISASSEMBLY OF CROMEMCO'S HEX FILE. IT CONTAINS NO CP/M 
I/O. THE PAPER TAPE AND THE MANUAL (WHICH YOU WILL HAVE TO 
OBTAIN ELSEWHERE) CONTAINED NO COPYRIGHT NOTICES AT ALL; I'M 
NOT SURE WHAT THE IMPLICATIONS OF THAT ARE. 


3DTICTAC.ASM -- THIS IS A THREE DIMENSIONAL TIC-TAC-TOE GAME WRITTEN 
BY THOMAS ROLANDER FORMERLY OF INTEL. IT CONTAINS NO CP/M I/O. 


PROCCALC.ASM -- THIS IS ANOTHER PIECE OF SOFTWARE DISTRIBUTED FREE 
BY PROCESSOR TECHNOLOGY. IT IS A 'DESK CALCULATOR' PLUS A 
BCD FLOATING POINT PACKAGE. THE SOURCE FOR THE FLOATING POINT 
PACKAGE IS A DISASSEMBLY. 


DISASM.COM -- THIS IS A VERY NICE DISASSEMBLER WHICH ORIGINALLY CAME 
FROM THE INTEL USER'S GROUP. IT HAS BEEN EXTENSIVELY IMPROVED 
AND 280 MNEMONICS HAVE BEEN ADDED. IT REQUIRES A HEX FILE AS 
ITS INPUT. AN EXAMPLE OF ITS INVOCATION IS: 


DISASM PROG.HEX [PROG.ASM] 


IF THE SECOND FILE NAME IS NOT PROVIDED, THEN THE PUNCH OUTPUT 
IS SENT TO THE CONSOLE. WHEN THE DISASSEMBLER COMES UP, IT 
ASKS IF THE OUTPUT IS TO BE PUNCHED. IF THE ANSWER IS NO, (N) 
THEN THE OUTPUT IS SENT TO THE CONSOLE AND THE OBJECT CODE IS 
LISTED AS WELL AS THE DISASSEMBLED SOURCE, SO THE OUTPUT LOOKS 
AS IF IT WERE COMING FROM AN ASSEMBLY. IF THE ANSWER TO THE 
FIRST QUESTION IS YES, (Y) THEN NO OBJECT CODE IS LISTED, 

AND A FURTHER QUESTION, 'WANT TABS?', IS ASKED. IF THIS 
QUESTION IS ANSWERED YES, (Y) THEN TABS ARE INSERTED IN THE 
OUTPUT SOURCE IN THE USUAL MANNER; OTHERWISE SPACES ARE USED. 
IF, WHEN THE DISASSEMBLER WAS INVOKED, A SECOND FILE WAS NOT 
SPECIFIED (THE FILE PROG.ASM IN THE EXAMPLE ABOVE), THEN THE 
SOURCE OUTPUT (WITHOUT THE OBJECT IN THIS CASE) WILL BE SENT 
TO THE CONSOLE. THE TYPE OF THE SECOND FILE IN THE EXAMPLE 
ABOVE WILL ALWAYS BE FORCED TO TYPE 'ASM', 

IF THE HEX FILE BEING DISASSEMBLED -HAS CODE WHICH 

DISASSEMBLES AS THOUGH IT REFERENCES ADDRESSES OUTSIDE THE 
REGION INCLUDED IN THE HEX FILE, THOSE ADDRESSES WILL BE 
ABSOLUTE QUANTITIES; OTHERWISE, THEY WILL BE SYMBOLIC LABELS. 


D> 


POLY-vu 
#PV119 


. CA 99503 


K&M Company 


TORRANC 


S 


| 


°o 


CPMUG vol. 19 _ — 10/19/85 


~CATALOGO19 1K 
ADE ASM 17K 
COPY ASM 6K 
CPM DOC 9K 
LINK ASM 21K 
LINK73 ASM 17K 
RM80 ASM 60K 
RM80 DOC 8K 
SAP ASM 4k 
SCOPY ASM 8K 
TREAD ASM 16K 
TSAVE ASM 10K 
VOLUME19DOC 6K 
XFER ASM 9K 
14 file(s). 

44 directory entries remaining. 
COSTAT O: 


Bytes Remaining On O: 49k 


C>TYPE O:-CATALOG.01§" =~ 
VOLUME 19 Ce 


VARIOUS UTILITIES 


NUMBER SIZE 


19.1 
19.2 
19.3 


19.4 


19.5 
19.6 


19.7 
19.8 


19.9 
19.10 


19.11 
19.12 


“> 


17K 
6K 
9K 
21K 


17K 
60K 


8K 
4k 


8K 
16K 


10K 
9K 


NAME 


CATALOG .19 
VOLUME19 . DOC 
ADE.ASM 

COPY .ASM 
CPM.DOC 
LINK.ASM 


LINK73.ASM 
RM80.ASM 


RM80.DOC 
SAP.ASM 


SCOPY.ASM 
TREAD.ASM 


TSAVE.ASM 
XFER.ASM 


COMMENTS 


CONTENTS OF CP/M GROUP VOL 19 

COMMENTS ON VOLUME CONTENTS 

ABSOLUTE DISK EDITOR. SEE VOL.DOC 

DISK COPY PROGRAM. SEE VOL.DOC 

IMSAI'S DESCRIPTION OF CP/M 

REMOTE COMPUTER CONTROL VIA D C HAYES 
MODEM BOARD. SEE VOL.DOC 

EARLIER VERSION OF 19.4 FOR STANDARD MODEM 
RESIDENT PROM MONITOR. SEE VOL.DOC AND 
RM80.DOC 19.7 

COMMENTS ON RM80 19.6 

SORTS AND PACKS DIRECTORY. SEE VOL.DOC AND 
XFER 19.12 

DISKETTE COPY PROGRAM FOR SINGLE DISK SYSTEM 
SEE VOL.DOC 

RM80 TAPE BACKUP UTILITY WITH 19.11 

RM80 TAPE SAVE UTILITY WITH 19.10 

FILE COPY PROGRAM FOR SINGLE DISK SYSTEM 
SEE VOL.DOC AND SAP 19.8 


TYPE VOLUMELSY. DOU 
Documentation for LEH Diskette 


ADE - Absolute Disk Editor 


Allows user to view contents of absolute sectors or tracks, either 

in absolute sector order, or CP/M 6:1 interlace order. Very useful 
eo when debugging disk i/o programs. Also useful for exploring an 

unknown diskette. For details on ADE commands, see source file. 


COPY - Absolute Disk Copy Utility 


Yet another disk to disk copy program. This one runs in about 1.5 min. 
It uses a 5:1 interlace. It also entertains the user while running. 


SCOPY - Absolute Disk Copy Utility for single drive systems 


Version of COPY which runs on a single drive CP/M system. On a 
32K system, 9 passes are required, for a total of 18 diskette 
swaps. Not terribly cool, but if all you got is one drive..... 


LINK ~ Communications Link Executive (for D C Hayes Modem Board) 


Allows user to link into remote processor via D C Hayes 80-103A 
modem board. Much more elaborate versions of this little jewel 
are in the works. All god's chillun ought to have a modem board. 
This program allows transfer of text files to and from disk. It 
appears to the remote system as a rather bright teletype. To use: 


LINK xxx~-xxxx Dial and await answer, then link 
LINK Jump to link immediately if carrier present 
C+) For further details on operation of LINK, see source file. 


LINK73 - Communications Link Executive (for outboard modem) 


Older version of LINK for you folks without Hayes modem boards, 
who do have outboard modems (or direct lines) to remote computers. 


RM80 - Resident Monitor for an 8080 or 280 System 


3K PROM monitor for a tape system. Currently set up for a Tarbell 
tape interface with motor control relays. Allows user to dump or 
enter memory in HEX or ASCII, read or write standard tarbell tapes, 
read, write, or scan its very own physical record format tapes (as 
used by TREAD and TSAVE). It also has a communications link facility 
with on-line loaders for object files or text files. Currently set 
up for outboard modem - version for D C Hayes board is planned. 
Lots of other goodies are detailed in the file RM80.DOC. This is a 
good way to help bring up your less fortunate friends who haven't 
yet figured out that disk is the only way to live. Also useful if 
you are responsible for other 8080 systems which don't have disks. 


SAP - Sort And Pack CP/M Directory 


Sorts CP/M directory, discards zero length files, and performs a 
re) pack on seperated chunks of a multi-extent file (see XFER). 


TREAD - Read RM80 Physical record format tapes to disk 


Useful for backing up disk files on (cheaper) cassettes. Also very 
useful for transferring files to a standalone tape system which is 


running RM80. ae 


TSAVE - Write CP/M disk files onto RM80 physical record format tapes t 


Complementary program to TREAD. My first CP/M code - don't laugh. 
XFER - Diskette to Diskette File Transfer Utility 


Allows user to transfer any size file from one diskette to another 
with a minimum of hassle. A copy of this should be kept on every 
diskette (if you have a single drive system), as it comes in quite 
useful is case of diskette crash. This little gem makes a single 
drive CP/M system livable. Multi-extent files may be transferred 
one extent at a time and rejoined at the other end via SAP. 


eee ITM PORTANT *** 


Please note that many of these programs require a more intimate 
interaction with the hardware than CP/M provides, hence must be 
edited and re-assembled for different memory and i/o configurations 
All versions supplied are for a 32K system with a PTC 3P+S at 0. 
When possible, CP/M standard I/O (via BDOS) was used. All other 

I/O is described fairly well in the internal documentation. 


I welcome helpful comments on any of the above code, but make no 
claims as to its perfection or applicability. (That means I will 
NOT fix or change things for free). All of the above code is 
hereby released into the public domain, for use in personal 8080 
or 280 computer systems. If you wish to obtain rights to use any 
of it for commercial purposes, please contact me. If you make 
lots of money from it without sending me a cut, your ears just 
might rot off (old family curse). Fairly elaborate extensions 

to CP/M are in the works, and will be announced via this club, 
and/or Dr. Dobbs. For further information, please contact me at 


Lawrence E. Hughes 

8080 Software Development Center 
1506 Myrick Road 

Tallahassee, Florida 32303 


Phone (904) 385-4573 or (904) 576-7866 
77/12/20 


A.R.G. - Note that Larry's sytem has his BIOS jump table 300H 
below the nominal MEMSIZE, not normal 200H. These references 
should be changed before assembly if you decide to run with 
the fixed memory size versions offered here. Also notice in 
ADE some fancy (and non-standard) footwork with the IOBYTE 

in order to get a listing and console output from the same 
subroutine. Suggest a revision here. 


O> 


saps 
(e 


TYPE CPM.DOC 
CPM DOCUMENTATION 


THIS FILE CONTAINS SHORT DESCRIPTIONS OF THE FILES PROVIDED BY 
DIGITAL RESEARCH. FOR FURTHER DOCUMNENTATION SEE THE DIGITAL RESEARCH 
CPM REFERENCE MANUALS. THESE INCLUDE THE FOLLOWING: 


AN INTRODUCTION TO CP/M FEATURES AND FACILITIES 

ED - A CONTEXT EDITOR FOR THE CP/M SYSTEM / USER'S GUIDE 
CP/M ASSEMBLER (ASM) / USER'S GUIDE 

CP/M DYNAMIC DEBUGGING TOOL (DDT) / USER'S GUIDE 

CP/M INTERFACE GUIDE 

CP/M SYSTEM ALTERATION GUIDE 

BASIC-E REFERENCE MANUAL 


THESE MANUALS (AND OTHERS, SUCH AS THE ML80 MANUAL) MAY BE OBTAINED 
EITHER FROM IMSAI OR DIRECTLY FROM DIGITAL RESEARCH, AT: 


DIGITAL RESEARCH 

POST OFFICE BOX 579 

PACIFIC GROVE, CALIFORNIA 93950 
PHONE 408-649-3896 


CCP (DIRECT) COMMANDS: 


IN THE FOLLOWING, UFN STANDS FOR 'UNAMBIGUOUS FILE NAME', WHICH 

IS OF THE FORM 'N:NAME.TYPE', WHERE N IS A DISK NAME (A OR B, OR 

CURRENT DISK IF OMITTED), NAME IS AN UP TO 8 CHARACTER FILE NAME, 

AND TYPE IS AN UP TO 3 CHARACTER FILE TYPE. TYPICAL UFN'S ARE 
FRED.ASM B:TEST.COM SALLY69 VOLUME. 001 


AFN STANDS FOR 'AMBIGUOUS FILE NAME', WHICH FOLLOWS THE RULE ABOVE, 
BUT THE CHARACTER ? MAY BE SATISFIED BY ANY SINGLE CHARACTER, AND 
THE CHARACTER * MAY BE SATISFIED BY ANY STRING OF ANY LENGTH. 


TYPICAL AFN'S ARE: * ASM XDIR. 80? B:I*.* 

DIR AFN ~ REQUEST LIST OF ALL FILE NAME IN THE DIRECTORY 
WHICH SATISFY THE AMBIGUOUS FILE NAME 

ERA AFN - ERASE ALL FILES WHOSE NAME SATISFIES THE 
AMBIGUOUS FILE NAME 

TYPE UFN - TYPE THE FILE SPECIFIED ON THE CONSOLE 

SAVE N UFN - SAVE N (DECIMAL) PAGES (OF 256 BYTES EACH) 


ON DISK, WITH NAME SPECIFIED 
REN UFN1=UFN2 - RENAME EXISTING FILE UFN2 WITH FIRST NAME SPECIFIED 
UFN - LOAD THE SPECIFIED FILE (ASSUMED TYPE 'COM') AND 
JUMP TO LOCATION 100H. 


SYSGEN.COM 
CP/M UTILITY TO TRANSFER THE SYSTEM IMAGE FROM ONE DISKETTE TO ANY 
OTHER. MAY ALSO BE USED JUST TO LOAD THE SYSTEM IMAGE INTO RAM, OR 
VICA VERSA. 
TYPICAL COMMAND: 
SYSGEN 
STAT.COM 


UTTtTTY COMMAND TO REOTIEST INFORMATTON AROUT REMATNITING SPACE ON THE 


CURRENT DISKETTE, OR SIZE DATA ON A PARTICULAR FILE OR GROUP OF FILES. 


TYPICAL COMMANDS: 


STAT REQUEST INFO ON AVAILABLE SPACE 
STAT ASM.COM REQUEST SIZE DATA ON FILE 'ASM.COM' 
re) STAT *.ASM REQUEST SIZE DATA ON ALL FILES OF TYPE 'ASM' 
PIP.COM 


GENERALIZED COPY UTILITY. MAY BE USED TO TRANSFER FILES FROM ONE DISK 
TO ANOTHER, OR FROM POINT TO POINT ON ONE DISK, OR FROM DISK TO AN I/O 
DEVICE (SUCH AS THE CONSOLE), OR FROM AN I/O DEVICE TO DISK. 


TYPICAL COMMANDS: 


PIP START PIP AND ALLOW MULTIPLE COMMANDS TO BE ENTERED 
PIP A:X=B:Y TRANSFER FILE Y FROM DISK B TO FILE X ON DISK A 
PIP B:FRED=A: TRANSFER FILE FRED ON DISK A TO FILE FRED ON DISK B 


ED.COM 


CONTEXT EDITOR. CREATES BACKUP FILE OF TYPE 'BAK' WITH NAME OF FILE 
BEING EDITED. WRITES NEW FILE WITH NAME AND TYPE OF ORIGINAL FILE 
FOR DETAILED DESCRIPTION OF EDITING COMMANDS, SEE CP/M MANUAL ON ED. 


TYPICAL COMMAND: 


r+) ED TEST.ASM 


ASM.COM 


SIMPLE INTEL-~FORMAT ASSEMBLER. NO MACROS OR RELOCATABLE CODE, BUT IT 
DOES HAVE CONDITIONAL ASSEMBLY. OTHERWISE REASONABLY COMPATIBLE WITH 
INTEL STANDARD ASSEMBLER (HOWEVER NOTE THAT SYMBOLS MAY BE LONGER THAN 
SIX CHARACTERS, WHICH IS THE MAX WITH THE INTEL ASSEMBLER. 

THE NAME OF THE FILE (NO TYPE) IS SPECIFIED AS THE FIRST PARAMETER 

IN THE INVOCATION. DO NOT SPECIFY TYPE 'ASM' - THE TYPE FIELD IS FOR 
SPECIFYING WHICH DISK THE THREE FILES ARE ON. INPUT IS ASSUMED TO 

BE ON FILE 'X.ASM', LISTING GOES TO FILE 'X.PRN' AND HEX OBJECT FILE 
GOES TO FILE 'X.HEX' (WHERE 'X' IS THE NAME SPECIFIED IN THE COMMAND) 


LINES WITH ERRORS WILL BE LISTED TO THE CONSOLE DURING ASSEMBLY. 
TYPICAL COMMANDS: 


ASM TEST - ASSEMBLE FILE TEST.ASM, CREATE TEST.PRN, TEST.HEX 
ASM TEST.ABX ~- ASSEMBLE FILE TEST.ASM (ON DISK A), CREATE FILE 
TEST.HEX (ON DISK B), AND SEND LISTING TO CONSOLE 


C+) LOAD.COM 


UTILITY PROGRAM TO TRANSLATE HEX FILES CREATED BY ASSEMBLER INTO 
COM FILES (MEMORY IMAGE / AUTO LOAD). FILE TYPE NEED NOT BE SPECIFIED 


LOAD READS STANDARD INTEL HEX OBJECT FILES FROM FILE 'X.HEX', AND A si 
CREATES A MEMORY IMAGE FILE ON FILE 'X.COM', WHERE X IS THE NAME Vv 
SPECIFIED IN THE COMMAND. 


TYPICAL COMMAND: 


LOAD TEST - CREATE FILE TEST.COM FOR EXECUTION BY TYPING 
JUST THE NAME 'TEST',. 


DDT.COM 


POWERFUL REAL-TIME DEBUGGING FACILITY, INCLUDING HEX MEMORY DUMP 
AND EDIT, SIMPLE ASSEMBLER/DISASSEMBLER, BREAKPOINTS, EXECUTION 
TRACE, AND REGISTER DISPLAY AND SET. 

FOR FURTHER DETAILS ON DDT, SEE THE CP/M DDT MANUAL. 


TYPICAL COMMANDS: 


DDT TEST.COM - LOAD THE FILE TEST.COM DIRECTLY AND START 
DDT TEST.HEX - LOAD THE HEX OBJECT FILE ON TEST.HEX AND START 
DUMP.COM 


HEX FILEDUMP FACILITY. ALLOWS USER TO DISPLAY CONTENTS OF ANY DISK 
FILE IN HEXADECIMAL. VERY USEFUL WHEN DEBUGGING PROGRAMS WHICH DO 
DISK I/O. 


TYPICAL COMMAND: 


DUMP TEST.COM - DISPLAY CONTENTS OF FILE TEST.COM IN HEX 


BASIC-E.COM 


BASIC COMPILER FROM NAVAL POSTGRADUATE LAB. TRANSLATES REASONABLY 
STANDARD BASIC, WITH DISK I/O REFERENCES INTO MACHINE LANGUAGE FOR 
A HYPOTHETICAL MACHINE. NOT PARTICULARY FAST OR ELEGANT. INPUT FILE 
IS ASSUMED TO BE OF TYPE 'BAS', OUTPUT FILE WILL BE OF SAME NAME, 
AS INPUT, BUT OF TYPE 'INT'. NOTE THAT THE OBJECT FILE CREATED IS 
NOT 8080 CODE, AND MAY ONLY BE RUN ON THE 'RUN-E!' 'INTERPRETER' 

FOR FURTHER DETAILS, SEE THE CP/M BASIC-E REFERENCE MANUAL. 


TYPICAL COMMAND: 


BASIC-E DEMO ~- COMPILE SOURCE PROGRAM ON 'DEMO.BAS' AND 
CREATE INTERNAL FILE ON 'DEMO.INT' 


re ee ee ee ee se ce eee ee ee ee es ree a ee eee ee se ee ce ce ae ee ec tO 


RUN-E.COM 


RUN-TIME 'INTERPRETER' FOR INT FILES CREATED BY BASIC-E. INPUT FILE 
IS ASSUMED TO BE OF TYPE 'INT'. 


TYPICAL COMMAND: 


RUN-E DEMO - EXECUTE THE PROGRAM ORIGINALLY COMPILED FROM 
FILE 'DEMO.BAS' 


SUBMIT.COM 


PROCEDURE FILE FACILITY. ALLOWS USER TO CREATE A STRING OF CP/M 
CONSOLE COMMANDS ON A DISK FILE (OF TYPE 'SUB') AND HAVE THEM 
EXECUTED ONE BY ONE. THE 'SUB' FILE MAY BE CREATED BY THE TEXT 
EDITOR, AND CONTAINS LINE IMAGES OF LEGAL CP/M COMMANDS, FOLLOWED 
BY CR AND LF. FOR EXAMPLE, SEE FILE ML.SUB. DUMMY PARAMETERS MAY 
BE USED AT ANY POINT IN THE SUB FILE ($N, WHERE N IS AN INTEGER). 
ANY FORMAL PARAMETERS SPECIFIED AT THE TIME THE SUBMIT COMMAND IS 
INVOKED (SUBMIT XXX Pl P2 P3 .-. PN, WHERE X IS THE NAME OF THE 
'SUB' FILE, AND EACH PI IS A PARAMETER) WILL BE SUBSTITUTED INTO 
THE TEXT OF THE SUB FILE POSITIONALLY. THE SYMBOL $1 WILL BE REPLACED 
BY THE FIRST PARAMETER, ETC. 


TYPICAL COMMAND: 
SUBMIT ML XDIR - SUBMIT FILE ML.SUB, WITH $1 REPLACED BY XDIR 


RM80.DOC 
RM80 V2.0 User's Guide 


RM80 is a PROM-resident monitor for an 8080 (or 280) system. It 
supports one console, one modem, and two cassette decks interfaced 
with a Tarbell Tape Interface, with relays. There are four main 
groups of commands: 


1) The hex monitor (edit memory in hex or ASCII) 
2) Standard Tarbell driver (read/write standard tapes) 
3) SDC Format tape driver (read/write RM80 tapes) 
4) Communications executive (allow link to remote CPU) 


All data entered from the console has the following editing 
facilities available before hitting the CR key: 


1) CTRL-U will abort the current line 
2) DEL (RUBOUT) will discard the previous character, 
and echo it to the console. 


Memory is allocated as follows (in the 24K version): 


0000-57FF User program and buffer area 
5800-5BFF Default system tape buffer 
5900-590A Default system filename buffer 
590B-590B Tape unit number buffer 
590C~590C Physical record number buffer 
590E-5C8D System input buffer 

5C8E-5CCD System stack 

CO00-CBFF 3K PROM containing RM80 


Once a program has been loaded in, and execution begun, assuming 
the stack pointer has the same value as when execution began, a 
simple RET will return you to RM80. At any point, a jump to location 
C000 will restart RM80. 


The commands are all in the same format: 
<KEYWORD> <BLANKS> <PARAM> <BLANKS> <PARAM> 


<KEYWORD> - is an up to 5 character word in the list of commands 
<BLANKS> - is a string of one or more blanks 
<PARAM> - is an up to 4 digit hex number 


Some commands will require further data before execution. These 
will prompt the user for that data. The MOVE command requires a 
destination address, so a valid response to the 'TO?' prompt is a 
<PARAM> as above. Anytime the prompt 'FILENAME?' occurs, any legal 
CP/M filename may be typed. A CP/M filename is of the form 


<name> or <name>. <type> 


<name> is any group of up to 8 ASCII characters 
<type> is any string of up to 3 ASCII characters 


Standard CP/M file types are as follows: 


ASM - Assembler source file 

HEX ~ Intel hex object file 

COM - Memory image object file (loads at 100H) 
BAS - BASIC source file 

FOR - FORTRAN source file 


KRIKKEK KE E ER K IK ERA RE RERESEREKRKRRERE ERR E RR ERERERERERE EE EEEEREEREREREKKEKE Fr 
an’ 
RMA Hex Monitor Commands \ 


DUMP fwa lwa 


Dump memory in hex and ASCII starting at fwa, ending at lwa. 
Control characters are printed as periods. Dumping may be 
aborted at any time by typing any character. 


TYPE fwa lwa 


Type memory in ASCII starting at fwa ending at lwa. All 
control characters print as themselves (exercise caution). 


ENTER fwa 


Allow user to enter memory contents in Hex. A four digit 
prompt 'xxxx?!' will be printed at the start of each input 
line, to show the user where the first byte typed on that 
line will be loaded into memory. The user may return to RM80 
by typing an empty line (CR right after prompt). 


MOVE fwa lwa 


Move block of memory starting at fwa ending at lwa to the 
area Starting at the destination address (supplied in response 
to the TO? prompt. Blocks may overlap either way. 


FILL fwa lwa 


Fill memory with constant supplied in response to 'WITH?! 
prompt, starting at fwa ending at lwa. 


GO fwa 


Jump to address fwa. Default is 100H. 


RARER KERR REE KEKE RRERRRERRREREEREEREKEEKRKEEERERERKRKEEEREREEKRS 


Standard Tarbell Tape Handler Commands 
STORE fwa lwa 


Store memory starting at fwa ending at lwa to tape in Tarbell 
standard format (data bytes then checksum). 


FETCH fwa lwa 


Fetch standard Tarbell file into memory starting at fwa, and 
ending at lwa. Note that the file size (lwa-fwatl) must be 
the same as the file size used in creating the file with 
STORE (or equivalent). The message 'CHECKSUM ERROR' indicates 
that data was lost (or user specified fwa and lwa wrong for 
this file). 


CHECK fwa lwa 


Same as FETCH, but data is not loaded into memory . Good 
for checking quality of files written with STORE. 


UNIT n 
Sets unit number for above commands (default = 1) 
Notes on using cassette tapes with RM80: 


Before writing data to tape, the user should put the recorder 
into RECORD and allow a reasonable leader (count to 10). The 


nase 


~ 


REMOTE cable (motor control) may be re-inserted and the WRITE 
command issued. Further files may be written without additional 
leader. When reading tapes, the cassette may be positioned 

any length of leader (and/or blank tape) before the actual data. 
Port FF lights will display data being written to or read from 
cassette tape. 
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SDC Tape Handler commands 


WRITE n 


Writes n pages (256 bytes each) starting at 100H, to tape 

in SDC format. A filename will be requested with the 'FILENAME?! 
prompt. When the entire file is written, RM80 will respond with 
'xxxx BYTES WRITTEN' and then provide a command prompt. 


WRITE fwa lwa 


READ 


LOAD 


DUMP 


TYPE 


SCAN 


UNIT 


As above, but the user nay specify any addresses. 
fwa 


Read next SDC format file into memory starting at fwa. 
Reading may be aborted at any time by typing any character. 
Default fwa is 100H. Header info is printed as each 

record is read into memory. 


Load Intel Hex Object Format file in SDC Format into memory 
at addresses specified in object file. Loading may be aborted 
at any point by typing any character. 


Dump next SDC format file to console in Hex and ASCII. 

Header info is printed as each record is read. Conventions are 
the same as the memory dump command. Dumping may be aborted 

as usual. 


Type next SDC format file to console in ASCII. Conventions are 
the same as the memory TYPE command. Typing may be aborted 
as usual. 


Read SDC tape and print header info until interrupted by any 
character from the console. 


n 


Select tape unit for all tape commands until respecified. 


re) Header info when printed, is in the following form: 


NAME = aaaaaaaa TYPE = aaa SIZE = dddd PRN = dd CRC = ssss 


aa...aa is an ASCII character string 
dd...dd is a Hex number 
ss...ss is the string 'GOOD' or 'BAD! 


¢¥ 
pms 


The SDC physical record format 1S as follows: 


FIRST NUMBER NAME CONTENTS 
BYTE OF BYTES 

00 01 SOH ASCII Start Of Header 

01 08 FN ASCII file name 

09 03 FT ASCII file type 

12 01 PRN Integer Physical record number 

13 02 PRS Integer Physical record size (HI/LO) 
14 01 STX ASCII Start Of Text 

15 prs DATA Data Bytes (normally 1024 of them) 
15+prs Ol ETX ASCII End Of Text 

l6+prs 02 CRC Integer Cyclic Redundancy Checksum (HI/LO) 


KEKE REE EERE EERKERERKEERKEKKEEREEKREKKAS 


Communications Link Executive 


LINK 


Establish communications link with remote computer. Characters from 
console are sent to the modem. Characters from the modem are 

typed on the console. Various control characters allow tape files 
to be sent or received, or downloaded. To return to RM80 at any 
time, type CTRL-X. This will not break the link, which may be 
re-entered by typing LINK again from RM80. 


CTRL-O 
CTRL-N 
CTRL-R 
CTRL-Q 
CTRL-X 


Enable Object File Loader 

Disable Object File Loader 

Enable Text File Loader 

Disable Text File Loader and write to tape 
Return to monitor 


RREKEEKEEKREREEREKE EKER EREEEREEKEEEREERERREREREERERERREREERREREREEKERKEREEEE 


O> 


ams 
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~CATALOG020 
BLACKJACBAS 
BLACKJACINT 
CIVILW BAS 
FOOTBALLBAS 
GOLF BAS 
GUNNER’ BAS 
GUNNER INT 
LUNAR1 BAS 
PINUP PIC 
PINUP1 PIC 
POKER BAS 
SNOOPY PIC 
STARTREKBAS 
STMASTERBAS 
STMASTERDOC 
STRTRK/1BAS 
TREKINST 
TWEETY PIC 
ZOSO 20 
20 file(s). 


37 directory entries remaining. 


D>STAT O: 


Bytes Remaining On O: 7k 


D>TYPE O:-CATALOG. 020 


VOLUME 20 


BASIC-E / CBASIC PROGRAMS 


PICTURES 


NUMBER SIZE 


20.1 8k 

20.2 8K 

20.3 9K 

20.4 7K 

20.5 3K 

20.6 7K 

20.7 9K 

20.8 18K 
20.9 9K 

20.10 4K 

20.11 27K 
20.12 57K 
20.13 1K 

20.14 33K 
20.15 7K 

20.16 7K 

D> 


NAME 


CATALOG. 20 
ZOSO. 20 


BLACKJAC.BAS 
CIVILW.BAS 
FOOTBALL.BAS 
GOLF .BAS 
GUNNER.BAS 
LUNAR1.BAS 
PINUP.PIC 
PINUP1.PIC 
POKER.BAS 
SNOOPY. PIC 
STARTREK.BAS 
STMASTER.BAS 
STMASTER. DOC 
STRTRK/1.BAS 
TREKINST 
TWEETY. PIC 


COMMENTS 


CONTENTS OF CP/M GROUP VOL 20 
REVIEWER PAYS 


OUR TALENTED AND MODEST 
TRIBUTE TO A WORTHWHILE 
PROG IN BASIC-E/CBASIC. 
PROG IN BASIC-E/CBASIC. 
PROG IN BASIC-E/CBASIC. 
PROG IN BASIC-E/CBASIC. 
PROG IN BASIC-E/CBASIC. 
PROG IN BASIC-E/CBASIC. 
PICTURE 

PICTURE 

PROG IN BASIC-E/CBASIC. 
PICTURE 

PROG IN BASIC~-E/CBASIC. 
PROG IN BASIC-E/CBASIC. 
SEE ZOSO.20 

PROG IN BASIC-E/CBASIC. 
SEE ZOSO. 20 

PICTURE 


SET 
SEE 
SEE 
SEE 
SEE 
SEE 
SEE 


SEE 


SEE 
SEE 


SEE 


OF SUBMISSIONS 
ZOSO. 20 
ZOSO. 20 
ZOSO. 20 
ZOSO. 20 
ZOSO. 20 
ZOSO. 20 


ZOSO. 20 


ZOSO. 20 
ZOSO. 20 


ZOSO. 20 


TYPE O:Z2050. 2u 


Z0SO'S HEROIC RETURN 


WELL IT APPEARS THAT 1978 WILL INDEED BE A BETTER YEAR (BASED ON THE PROGRAMS 
OMING IN SO FAR). AFTER THE POLICE CAME ON NEW YEAR'S EVE AND TOOK MY UNDER- 
AGED HAREM BACK TO THEIR RESPECTIVE FAMILIES, I HAD SOME SERIOUS DOUBTS AS TO 
WHETHER I'D BE ABLE TO GET THIS COLUMN OUT ON TIME. HOWEVER THAT'S ANOTHER 
STORY, AND FAMILIARITY BREEDS CONTEMPT; SO I'LL DISPENSE WITH THE NEWSY STUFF 
AND PROCEED WITH BUSINESS. THESE PROGRAMS ALL COMPILED AND RAN PROPERLY (VER- 
SION K2.0 PKG.), WITH THE EXCEPTION OF 'STMASTER.BAS' WHICH MAY NONETHELESS BE 
BEST ITEM OF THE LOT; (WHEN SOMEBODY TAKES THE NOT INCONSIDERABLE TIME TO FIX 
IT UP). 


WITHOUT FURTHER CEREMONY, HERE ARE THE BASIC~-E GAMES FOR THIS RELEASE (AND OF 
COURSE MY INSIGHTFUL AND ERUDITE COMMENTARY). 


STMASTER.BAS 
THIS LOOKS LIKE IT COULD BE A WINNER ! I REFER YOU TO THE CONTRIBUTORS REMARKS 
IN-RE THIS PROGRAM (STMASTER.DOC). NOTE THE SIZE OF THIS FILE !!! DO NOT EVEN 


BOTHER TO TRY, UNLESS YOU ARE RUNNING WITH 64K (AND OF COURSE A 64K SYSTEM). 
WOULD THE 'DIGITAL-RESEARCHERS' EXPLAIN JUST WHY THE ATTEMPT TO CREATE A 64K 
SYSTEM RESULTS IN A MESSAGE INDICATING THAT 'RELOC' HAS CREATED AN I6K (THAT'S 
RIGHT, I6 NOT 16K) CP/M ? TO ADD TO WHAT MR. PIERCE SAYS, ONE CAN ALSO COMPILE 
THIS WITH VER. K2.0 OF BASIC-E. WHEN I TRIED TO RUN IT, I GOT SEVERAL LINES 
OF STARTREK, THREE OVERFLOW WARNINGS (WRITTEN FOR BIGGER MACHINES I'D BET) AND 
AN ABRUPT RETURN TO CP/M. THIS MAY HAVE BEEN DUE TO THE 'STOP' STATEMENTS WHICH 
APPEAR IN SEVERAL PLACES IN THIS FILE. BY THE WAY, WHAT IN GOD'S NAME DOES ONE 
USE THE 'STOP' FUNCTION FOR IN BASIC-E ANYWAY ? ONE ACHIEVES ALMOST THE SAME 
EFFECT BY HITTING RESET DURING SOME DRUNKEN STUPOR. ODDLY, WHEREAS, THIS COM- 

ILED WITHOUT ERROR IN BASIC-E, AN ATTEMPT TO COMPILE IN C-BASIC RESULTED IN 

N 'UNMATCHED FOR STATEMENT'. TO THE GOOD SOUL OUT THERE WHO WILL TAKE THE TIME 
TO MAKE THIS RUN RIGHT, DISABUSE YOURSELF OF ANY IDEAS YOU MAY HAVE OF TRYING 
TO GET THIS UP IN EITHER C-BASIC OR MICROSOFT DISK-BASIC; 64K JUST AIN'T ENOUGH 
MEMORY. WHOEVER GETS THIS RUNNING WILL EARN MY SINCEREST THANKS AS IT LOOKS 
LIKE IT WOULD REALLY BE GREAT FUN. 


STRTRK/1.BAS 

ONE OF THE MORE ENTHUSIASTIC REVIEWS OF WHICH I HAVE FOUND MYSELF CAPABLE IN 
RECENT MEMORY WAS UTTERED ON BEHALF OF A STARTREK PROGRAM. THE ONE TO WHICH 

I SPECIFICALLY REFER WAS CALLED 'STARTREK.BAS', AND WAS FIRST RELEASED AS ITEM 
NUMBER: 3.34 OF VOLUME 3. I HAVE TAKEN THE LIBERTY OF RENAMING THIS SUPER !!1 
UPGRADE TO AVOID CONFUSION. THE GENTLEMAN WHO SUBMITTED THIS INCLUDED A BRIEF 
ENTREATY TO MY MORE CHARITABLE INSTINCTS... NOT NECESSARY, J.P.; THIS AND THE 
OTHER THINGS YOU SENT HELP RESTORE MY FAITH IN THE 'CALIFORNIA REPUBLIC', AND 
MORE IMPORTANTLY, FAITH THAT SOME PEOPLE WILL SHARE 'A-1' PROGRAMS WITH US. 
OTHERS WHO HAVE SUBMITTED GARBAGE HAVE INVITED SOME OF MY CHEAPEST SHOTS AND 
SOME OF MY MOST HEARTFELT VITRIOL. EVEN IN MY GLOOMIEST MOMENT, I WOULD NEVER 
SAY ANYTHING UNFLATTERING ABOUT A MASTERPIECE SUCH AS THIS (I MEAN IT !1) 

ONE GRIPE INVOLVES THE [ADVERTISING] 'SLOW-GUNS' WHICH WERE FILCHED FROM AN 
OTHERWISE WASTED PROGRAM, SUPTREK3.ASC, (NUMBER 5.24 ~ VOLUME 5). MY ADVICE IS 
TO ISOLATE THE THREE OFFENDING SUBROUTINES, AND REPLACE EACH WITH A SIMPLE 
"RETURN'; THE REMAINING PROGRAM WILL BE A DELIGHT !!!!!!! BY THE WAY, THE 


ORIGINAL FROM WHICH THIS UPGRADE HAS BEEN CREATED HAS BEEN INCLUDED ON THIS 
DISK (STARTREK.BAS). 


sUNNER.BAS 
oom REHASH OF 'CANNONS.BAS' (VOLUME 3.9) LENDS NEW MEANING TO THE CONCEPT 
OF BATTLE-FATIGUE. THE MAJOR WORKOUT WHICH I HAVE GIVEN THIS PROGRAM WAS 
TO ALLOW A FRIEND'S NINE YEAR OLD DAUGHTER TO PLAY IT. I FIGURED THIS ONE 
, WOULD BE EASY ENOUGH FOR HER TO PLAY, A PACIFIER IF YOU WILL. IN ABOUT FIVE 
3 MINUTES THIS NORMALLY WELL-MANNERED LITTLE GIRL ANNOUNCED, "'UNCLE ZOSO', 
‘| THIS IS REALLY BOOOOORING". THE KID WAS RIGHT !!! ALSO THIS SHOPWORN ITEM 
HAS AN EXPENDED ROUNDS COUNTER (NECESSARY BECAUSE THE OBJECT IS TO 'DEMO! 


THE TARGET IN 5 SHOTS OR LESS). PERHAPS PROGRAMMING SUCH AD ‘His 4A7 GA Wo 
THE MILLIONS OF DOLLARS WORTH OF ORDNANCE WHICH TURNS UP MISSING EVERY TIME 
WE HAVE A WAR. 


LUNAR1.BAS 
UNTIL NOW MIXED REVIEWS HAVE GREETED AN ASSORTMENT OF FORGETTABLE PROGRAMS 


WHICH (WITH VARIOUS VERSION NUMBERS) WERE CALLED, 'LEM', 'ROCKET', 'LUNAR' AND 
eo LANDER'. THE OBJECT OF THE ABOVE-MENTIONED WAS TO MAKE A SOFT LANDING ON THE 
MOON WITH A FINITE FUEL SUPPLY. THIS PROGRAM IS (FORGIVE ME) LIGHT-YEARS BETTER 
THAN ANY OF THOSE !!! HERE THE OBJECTIVE IS TO MAKE A SMOOTH LANDING, WITH THE 
SAME LIMITED FUEL - BUT ALSO TO LAND ON A TARGET (ON MOON'S SURFACE) WHICH IS 
NOT INITIALLY IN A FALL-LINE WITH YOUR 'LUNAR-LANDER'. THE MOON'S ROTATION ON 
ITS AXIS WILL BRING THE 'LANDING-AREA' WITHIN RANGE FOR ONLY A FEW MOMENTS. 
IF I MIGHT REVERT TO THE COP-OUT OF ANALOGY, THIS IS TO ITS PREDECESSORS AS THE 
OB2 (A BRITISH VESSEL [ROYAL MAIL SHIP]) IS TO THE PEQUOD (WHERE AHAB LET HIS 
EGO RUN AMOK). THERE ARE SUPERB SURPRISES HERE... PLAY IT !!! I'LL GIVE IT AN 
'A-', AND IT MISSES 'A+' ONLY BECAUSE A BOGUS TIMING ROUTINE IS INCLUDED, WHICH 
WOULD BE FAR MORE IMPRESSIVE IN 'REAL-TIME'. 


BLACKJAC.BAS 

TO SET THE RECORD STRAIGHT, I LIKE THIS RENDITION OF '21'. WERE IT NOT FOR MY 
HAVING COMMITTED SO MUCH TIME TO THIS TEDIOUS COLUMN, I JUST MIGHT HAVE DONE 
SOME WORK ON THIS FILE. THE GAME WORKS WELL, BUT COULD USE A TOUCH-UP ON ITS 
FORMATTING. I COULD PERSONALLY DO WITHOUT THE SNOTTY MESSAGES THAT GREET THE 
CONCLUSION OF EVERY HAND; AND, AT LEAST WITH MY OWN COPY, REST ASSURED THAT 
THEY WILL BE SWIFTLY EXCISED... A SUSPICIOUS THING: ONE ALLEGEDLY CAN EFFECT 
A 'SHUFFLE' BY ENTERING '7777'; EITHER A PHONY ROUTINE OR THE FASTEST SHUFFLE 
(BY FAR) YET IMPLEMENTED ON ANY EIGHT-BIT MACHINE. I POSSESS ONE SUCH ROUTINE 
IN 8080 ASSEMBLY LANGUAGE (WHICH I THOUGHT QUITE FAST). COMPARED TO THE 'SHUF- 
FLE' IN THIS PROGRAM, THE ASSEMBLER VERSION REMINDS ME OF AN AGING TURTLE 
SLOGGING THROUGH A PUDDLE OF QUICK-DRY EPOXY. 


OLF.BAS 
F;00D PROGRAM; LOTS OF RULES, OPTIONS ETC. I LIKE THE IDEA HERE, BUT ISN'T 

GOLF SOMEWHAT DULL WITH [ONLY] TEXTUAL REPRESENTATION; EVER WONDER WHY LIVE 
MATCHES ARE NOT AIRED ON RADIO ? WHY DOESN'T SOMEONE GET THIS ONE UP ON A TEK- 
TRONIX STORAGE SCOPE AND THEN SEND ME THE REVISED PROGRAM (AND THE SCOPE OF 
COURSE) SO I CAN RUN IT. I PROMISE TO RETURN THE SCOPE (CROSS MY HEART)! WOULD 
ZOSO LIE ? 


FOOTBALL.BAS 

THIS SIMULATES GUESS WHAT. IT DOES SO RATHER NICELY, AND UNLIKE 'NFL.BAS' 
(VOLUME 13.14) IT WORKS. THERE ARE COMPREHENSIVE RULES AND MANY STRATEGY 
OPTIONS. I DO HOWEVER LAMENT THE PASSING OF THE HALF-TIME SHOW WHICH WAS 
THE HIGHLIGHT OF THE ABOVE MENTIONED CATASTROPHE. PERSONALLY, I AM JUST 
A BIT DOWN ON FOOTBALL IN GENERAL. MAYBE I'M STILL BITTER ABOUT HAVING 
LOST MOST OF MY CONSIDERABLE WEALTH ON A PRE-SEASON BET IN WHICH I PICKED 
THE TAMPA BAY BUCCANEERS TO WIN SUPER BOWL XII. 


POKER.BAS 
USUALLY WHEN I REVIEW THIS STUFF I GET A FAIRLY RELIABLE PSYCHIC PICTURE OF 
THE TALENT RESPONSIBLE FOR A PARTICULAR IDEA, AND ITS EXECUTION. I MUST ADMIT 
THAT THIS ONE HAS ME STUMPED. THIS IS '5-CARD DRAW POKER'; AND THIS HERCULEAN 
(SERIOUSLY) UNDERTAKING IS CARRIED OFF REALLY WELL. [ DRAW YOUR CARDS ONE AT A 
TIME ( EACH A SEPARATE INPUT, SEPARATED BY A <CR> ) ]. THIS PROGRAM HAS A GROSS 
FLAW... A HAND IS CONSIDERED 'TIED' IF ITS 'RANKING' EQUALS THAT OF THE OTHER 
HAND. FOR EXAMPLE YOU HAVE A PAIR OF KINGS AND THE COMPUTER HAS A PAIR OF TENS, 
THAT'S RIGHT, IT'S A TIE !1! TO PUT IT ANOTHER WAY, TO BEAT A SIX-HIGH, YOU 
VOULD NEED AT LEAST A PAIR OF DEUCES. THE SCREEN FORMATTING OF THIS GAME IS 
GOD-AWFUL AND THERE ARE AT LEAST A DOZEN THINGS WELL WORTH CHANGING... TOUGH 
DARTS !!! TAKE A LOOK AT THE CODING; IF YOU FEEL THAT YOU CAN CHANGE THIS 
FOR THE BETTER [EASILY], THEN I JUST MAY DROP IN UNINVITED, WITH HOPES OF 
wo SELLING YOU SUBMERGED LAND BY THE FLORIDA COAST. IS THIS A WINNER, OR MERELY 
»? AN OBSCURE IMPLEMENTATION BY AN EXPERT (ONCE AGAIN, NO JOKE) PROGRAMMER ? TO 
+ BE HONEST, I DON'T HAVE THE FOGGIEST. I GUESS I'M PUT OFF BECAUSE I WAS NOT 
ABLE TO REVISE THIS TO MY LIKING IN 'NO-—TIME-FLAT', AS IS MOST OFTEN THE 


CASE. REGARDLESS OF WHAT I SAY, EXAMINE THE SUURUCEB VU. inad Unsp 2 Wow ees _ ss 
IMPROVEMENTS THAT MAY ARRIVE FROM THOSE WITH THE PATIENCE TO UNRAVEL THE SIN- 
GULAR (AND BARELY COMPREHENSIBLE) APPROACH THAT TYPIFIES THIS ITEM. 


* PIC 
THIS IS A GENERAL REVIEW OF SEVERAL ROUTINES ON THIS DISKETTE WHICH HAVE THE 


FILETYPE '.PIC': THESE ARE THE ONES WHICH PRINT THOSE LOVELY AND TASTEFUL 
@eicrvres ON A HARDCOPY DEVICE (N.B. MUST BE AT LEAST 80 CHARS. WIDE). HONESTLY, 
MY 'PIED-A-TERRE' (FOR YOU SPECIALISTS - THAT'S FRENCH FOR 'FLAT', WHICH IS, 
IN TURN, ENGLISH FOR 'RESIDENCE') IS DECORATED WITH THE WORKS OF STRUGGLING 
ARTISTS, I AM SO FOND OF MY MONETS, DALIS, MONDRIANS, POLLACKS, PICASSOS, 

DA VINCIS, CEZANNES ETC. THAT I JUST CAN'T SEEM TO FIND THE WALLSPACE WITH 
WHICH TO DO JUSTICE TO THESE CONTEMPORARY ('.PIC') MASTERPIECES. SECRETLY, I 
WISH THAT 'SNOOPY.PIC' WOULD SUCCUMB TO DISTEMPER. HOWEVER, DO NOT LET MY 
TASTES SPOIL YOUR APPRECIATION OF THE FINER THINGS... I HAVE READ SOME OF YOUR 
FAN-MAIL, AND IT IS APPARENT THAT SOME OF YOU ARE BLESSED WITH 'BINARY-SEX— 
HABITS' (DON'T ACT SURPRISED !!); YOU KNOW WHO YOU ARE, AND HAVE I GOT A TREAT 
IN STORE FOR YOU... DIM YOUR ROOM LIGHTS, ADJUST YOUR CRT FOR 300 BAUD, MAKE 
SURE YOU ARE ALL ALONE, AND THAT YOU HAVE PLENTY OF KLEENEX. THEN STEP BACK 
ABOUT 10 FEET, GET REAL COMFY AND RUN 'PINUP1.PIC'... ENOUGH SAID... 


CIVILW.BAS 

IMAGINE THAT YOU ARE A CONFEDERATE GENERAL MORE THAN A CENTURY AGO; THE DECK 
IS STACKED AGAINST YOU !! THE WEATHER IS INHOSPITABLE; YOU ARE OUTMANNED, OUT 
GUNNED, RUNNING SHORT OF FOOD, AMMUNITION, MONEY AND SOLDIERS. SOME GREASY 
BARBER WITH TOBACCO JUICE ALL OVER HIS FACE AND SHIRT HAS JUST HAD TO AMPUTATE 
YOUR GANGRENOUS LEG, AND IT'LL BE A WHILE BEFORE YOU'LL AGAIN BE IN THE MOOD TO 
RAPE ANY MORE YANKEE WOMEN. THIS GAME BYPASSES ALL SUCH NICETIES AND FUN. IT 
DOES HOWEVER CRASH ON OCCASION (UNWRITTEN ERROR TRAPS), AND IT PRODUCES A LOT 
OF MEANINGLESS BATTLE-REPORTS. EVERY BATTLE OF THE CIVIL WAR WHICH I REMEMBER 
FROM AMERICAN HISTORY (AND QUITE A FEW I DON'T RECALL) CROPS UP DURING THIS 
PSEUDO-HISTORICAL BRAIN-DULLER. EACH BATTLE IS SO BRIEF, AND SO LIKE EACH 

F THE OTHER BATTLES THAT THE NET EFFECT IS NOT UNLIKE READING MAJOR (DID I 

EALLY SAY MAJOR ?) LEAGUE BOX-SCORES. YOU DON'T REALLY HAVE TO PUT YOURSELF 
IN THE SHOES (OR PERHAPS SHOE) OF THAT REAL CONFEDERATE GENERAL. JUST REMIND 
YOURSELF THAT THIS IS 1978, AND INSTRUCT YOUR COMPUTER TO IGNORE THIS PROGRAM. 


POSTSCRIPT 


IN MY LAST COLUMN, I THREATENED TO REVEAL THE ZIP-CODE(S) OF PEOPLE WHO WERE 
SELLING 'INT' FILES TO THE UNWARY. AT THAT TIME I SUGGESTED THAT SUCH SUB- 
ETHICAL PRACTISES SHOULD BE RECTIFIED WITHIN 60 DAYS...(OR ELSE !!!). IT HAS 
BEEN BROUGHT TO MY ATTENTION THAT THE COMPUTER MAGAZINES WHICH RUN THESE ADS 
INSIST THAT FINAL AD-COPY MUST BE AVAILABLE TO THE MAGAZINE WELL (MORE THAN 
60 DAYS) IN ADVANCE OF PUBLICATION. SO AT THIS POINT IT JUST DOESN'T SEEM 
QUITE RIGHT TO EXPECT THAT ANYONE COULD HAVE CHANGED THEIR ADS TO READ, 'RAW 
MACHINE CODE' INSTEAD OF, 'WRITTEN IN C-BASIC', AS THEY PRESENTLY APPEAR. I 
GUESS IF ONE IS GOING TO BE TOUGH, ONE MAY AS WELL BE FAIR. 


I'M COMING HOME I'VE DONE MY TIME... 
ZOSO 


TYPE TREKINST 
Welcome to: 


Quis is a game of galactic conflict between the starship 
ENTERPRISE and a surly horde of Klingon (or Romulan, or 
Tholian) Destroyers. You are the Captain in charge of 
the Enterprise and it is your duty to eradicate the Klingon 
(or Romulan, or Tholian) menace from the galaxy. 


The galaxy is divided into 64 quadrants in the form of an 
8x8 grid. Each quadrant is further subdivided into an 8x8 
array of 64 sectors. This is the shape of the playing field. 


You will be assigned a starting point somewhere in the gal- 
axy to begin a tour of duty. You have at your disposal the 
wisdom of the officers of the Starship Enterprise to guide 
you as you unleash the full destructive capabilities of the 
Enterprise in your eternal quest for peace in the galaxy. 
Here are the commands that are available to you: 


N-AVIGATE 


This command is used to control your warp drive (FTL). There 
are two variables that you must set in order to use your warp 
drive. The first is the direction. This is set by entering 
a number greater than or equal to one and less than nine. 

the numbers represent the following directions: 


9 4 5 6 


\ I / 

3 - E 7 
/ I \ 

2 1 8 


The second variable is the distance or warp factor. One warp 

factor is the size of one quadrant. The warp factor must be 

entered as a decimal fraction to move sectors instead of quad- 

rants. I.E., Enter .375 to move 3/8'ths of a quadrrant or 3 sectors. 


S-HORT RANGE SCAN 


This readout shows you a scan of every sector of the quadrant 
that your are in. The symbology is as follows: 


Empty Space 

A Star 

A Klingon Warship 
Romulan Battle Cruiser 
Tholian Fighter 

A Friendly Starbase 
Spacecrud 

The Enterprise 


y The short range scan will also give a status report including the 
} 


MvumOawn re 
gouununo 


yf current condition code. The codes are as follows: 
\ 
GREEN = Scanners Clear 
YELLOW = Enternr ce 2 ae wv ~ cee 


ORANGE 
RED 


One Kiingon in Quadrant 
More Than One Klingon in Quadrant 


L-ONG RANGE SCAN 


This scan shows the conditions in space for one quadrant on each 

ide of your present quadrant (which is in the middle of the scan). 
The scan is coded such that the units digit is the number of stars, 
the tens digit is the number of starbases and the hundreds digit is 
the number of Klingons. For example: 


207 = 2 Klingons, no bases, 7 stars 


When you issue a Long Range Scan, the data collected is stored in 
the Galactic Map for access through the Enterprise's central com- 
puter (See 'C'). If a quadrant displayed is outside the galactic 
limits, it will be displayed as "***", 


P-HASER CONTROL 


Phasers are concentrated bursts of coherent energy that have great 
disruptive force at close range. They can be effective against 
several targets at once, and are very fast at firing. You can set 
the amount of energy to use in a single burst but it is easy to 
use up all of your energy if you are not prudent. 


T-ORPEDO CONTROL 


You may fire Photon Torpedoes at the Klingons with this command. You 

ee. set the torpedo course in the same way it is set for the star- 
Ship. Torpedoes take longer to unlimber and give the Klingons more 
opportunity for counter-attacks. Aiming is greatly enhanced through 
the use of the central computer (See 'C'). 


E-NGINEERING 


The 'E' command will put you in touch with the engineering section 

of the Enterprise and they will allow you to set the amount of energy 
that you wish to divert into your shields. Every time you are hit 

by enemy phaser fire your shields will be reduced. If they fall too 
low the damage you suffer will be severe. It is a good idea to set 
them high before going into battle. If you attempt a warp that is 
consuming a lot of energy, engineering will transfer some shield power 
to the warp drives. When you leave a starbase your shields will be at 
zero, so don't forget to reset them. 


D-AMAGE CONTROL 


Damage control will give a numerical status report on the various 
sensitive devices on board. A positive number indicates that the 
device is still operational. A negative number shows that the device 
is not functioning. Sometimes a particular device can sustain sev- 
eral hits and still remain positive (functional). If the 'D' com- 
mand is issued when the Enterprise is docked, it will serve as a 
summons to the repair facilities of the starbase. The Base repair- 

ra persons will fix all non-functional equipment on board but they do 

Ve consume precious time. 


C-OMPUTER 


This command will 
computer, an 8080 


1 


put you in direct communications with the central 
based system. There are five options available: 


Galactic Map. This is a print of the entire 
galaxy similar to a long range scan. Data is 
entered in the G-Map by the 'L' command. 

If a displayed quadrant has not been scanned 


by the long range sensors, it will be displayed 
as "???". 


Status Report. This tells the time remaining 
the number of starbases remaining and the num- 
ber of Klingons remaining. 


Torpedo Target Data. This will give the direc- 
tion and distance to all Klingons in the quad- 
rant. The direction may be used for firing 
photon torpedoes. 


Starbase Navigation Data. This will give the 
direction and distance to the starbase in the 
quadrant. 


Navigator. This will assist you in calculating 
the direction and distance to and from any quad- 
rant or sector in the galaxy. 


Anything else will cause a list of valid commands to 
be displayed to jog your faulty RAM. 


D> 


Good Luck and Good Hunting! 
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Altered .ASC to .BAS 6/5/85 Original version as in catalog. 
-CATALOGO21 8K -CATALOGO21 3K 
ACYDUCY BAS 3K ACYDUCY ASC 3K 
APOLLO BAS 3K APOLLO ASC 3K 
BANNER-~ BAS 38K BANNER- BAK 3K 
BIO BAS 4k BIO ASC 4k 
BLKFRIS BAS 10K BLKFRI3 ASC 10K 
BLKJK BAS 5K BLKJK ASC 6K 
CHASE BAS 4K CHASE ASC 3K 
CHESS BAS 12K CHESS ASC 12K 
DIAMONDSBAS 1K DIAMONDSASCG 1K 
ENTE BAS 4K ENTE ASC 4K 
ENTEP BAS 4K ENTEP ASC 4K 
FURS BAS 6K FURS ASC 6K 
HORSE BAS 6K HORSE ASC 6K 
KING BAS 8K KING ASC BK 
LANDER- BAS 38K LANDER ASC 3K 
MANDALA BAS 2K MANDALA ASC 2K 
MAZE BAS 5K MAZE ASC 4K 
PUZZLE BAS 4K README poc 1K 
PUZZLE COM 18K ROCKET ASC 3K 
README DOC 1K RUSSIAN ASC 3K 
ROCKET BAS 3K SNOOPY ASC 4k 
More.. More.. 

RUSSIAN BAS 3K STRTRK/2ASC 21K 
SNOOPY-2BAS 4K STRTRK/3ASC 20K 
STRTRK-2BAS 21K _ TACOS ASC 1K 
STRTRK-3BAS 20K TAXMAN ASC 5K 
TACOS BAS 4K TRADE ASC 16K 
TAXMAN BAS 5K TRAP ASC 2K 
TBANNER BAS 4K W/SEARCHASCG 4K 
TRADE BAS 16K WARI ASC 3K 
TRAP BAS 2K WUMP ASC 7K 
W-SEARCHBAS 4k ZO0S021 DOC 19K 
WARI BAS aK zoso21 TOP 20K 
WUMP BAS 6K 33 file(s). 

Z0S021 DOC 19K 


35 file(s). 


25 directory entries remaining. 


COSTAT O: 


Bytes Remaining On O: 21k 


C> 


C>Version I doas not have ZO0S021.TOP but does have PUZZLE.B 
PUZZLE.COM, and TBANNER.BAS (was 


-ASC). 


25 directory entries remaining. 


C>STAT O: 


Bytes Remaining On O: 11k 


C> 


to avoid duplicating a different file of the same name. 


AS (was .ASC), 
SNOOPY.ASC renamed SNOOPY-2.BAS 


TYPE O:-CATALOG.021 
VOLUME 21 


MICROSOFT BASIC PROGRAMS 


NUMBER SIZE NAME COMMENTS 
CATALOG .21 CONTENTS OF CP/M GROUP VOL 21 
zosoe1 ..DOC UNCHARACTERISTIC FOR zZOSO. HE LIKES SOME 
OF THESE PROGRAMS 
Z0S021 .TOP SAME AGAIN BUT WITH FORMATTING FOR TDL 


TEXT OUTPUT PROCESSOR. SHAME THEY DIDN'T 
THINK TO PERMIT DISK FILE OUTPUT FOR THIS 
RUNOFF, BUT THEN PAPER TAPE IS SO MUCH BETTER!! 


TDOL.HYP UNSOLICITED TESTIMONIAL 
21.1 3K ACYDUCY .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.2 3K APOLLO.ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.3 3K BANNER .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021.DO0C/TOP 
21.4 4k BIO.ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.5 10K BLKFRI3 .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.6 6K BLKJK.ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.7 3K CHASE .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOQC/TOP 
21.8 12K CHESS .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.9 1K ; DIAMONDS .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021.D0C/TOP 
21.10 4K ENTE.ASC PROGRAM IN MICROSOFT BASIC. SEE zZ0S021 .DOC/TOP 
21.11 6 ENTEP .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DO0C/TOP 
21.12 6K FURS .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.13 6K HORSE .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.14 8K KING .ASCG PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.15 3K LANDER.ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.16 2K MANDALA .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021.D0C/TOP 
21.17 4K MAZE .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.18 3K ROCKET .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021.D0C/TOP 
21.19 3K RUSSIAN.ASC PROGRAM IN MICROSOFT BASIC. SEE zZ0S021 .DOC/TOP 
21.20 4K SNOOPY.ASC PROGRAM IN MICROSOFT BASIC. SEE zZ0S021 .DOC/TOP 
21.21 21K STRTRK/2.ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.22 20K STRTRK/3 .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.23 1K TACOS .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021 .DOC/TOP 
21.24 5K TAXMAN .ASC PROGRAM IN MICROSOFT BASIC. SEE zZ0S021 .DOC/TOP 
21.25 16K TRADE .ASC PROGRAM IN MICROSOFT BASIC. SEE z0S021.D0C/TOP 
21.26 2K TRAP .ASC PROGRAM IN MICROSOFT BASIC. SEE zZ0S021.D0C/TOP 
21.27 4K W/SEARCH ..ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021.DOC/TOP 
21.28 3K WARI .ASC PROGRAM IN MICROSOFT BASIC. SEE Z0S021.D0C/TOP 
21.29 7K WUMP .ASC PROGRAM IN MICROSOFT BASIC. SEE z0S021.DO0C/TOP 


A>TYPE O:README .DOC 


THERE ARE TWO SIMILAR (TEXTUALLY) FILES ON THIS DISK. THE FILE 'ZOS0.3B' IS 
MY USUAL COLUMN; THE FILE 'ZOSO3B.TOP' HAS BEEN PREPARED FOR 80 CHARACTER 
(SORRY VDM'ERS) PRINTING ON THE TDL TEXT OUTPUT PROCESSOR. THE CONTENTS OF 
EACH ARE THE SAME... IF YOU DON'T OWN THE T.O.P. GET IT ANY WAY YOU CAN... 
ALSO Z-TEL (TDL'S SUPER-EDITOR) IS WELL WORTH ACQUIRING... 


Z0soO 


A> 


Lose alt 


TYPE O: SORE ji DUC 


1978 
BACK FROM THE WARS... 


LET'S GET REACQUAINTED. NO, LET'S NOT !!! I HAD A CHANCE TO USE THIS PROJECT 
AS A SPRINGBOARD TO LITERARY RECOGNITION... IT WAS ALL SET... WHAT HAPPENED ? 
SIMPLE, I WAS TOLD TO START CROSS-REFERENCING (SINCE SO MANY SEMI-DUPLICATIONS 
SEEM TO BE ARRIVING). I AM NOW SUPPOSED TO TELL YOU WHERE I HAVE SEEN THINGS 
BEFORE... I CANNOT WRITE THIS WAY, MY NORMAL CONGENIAL FLOW WILL BE INTERRUPTEI 
BY THE MENTION OF THE [VOLUME.NUMBERS] WHERE I RECALL HAVING SEEN EXAMPLES OF 
ALL THESE PETTY PLAGIARISMS THAT ARRIVE. RULES ARE MADE TO BE BROKEN !!! AFTER 
MY LAST DISCOURSE, I DECIDED TO TAKE A BRIEF 'CALIFORNIA-VACATION' (YOU KNOW, 
OUT THERE WHERE THE GRASS IS GREENER — THAT MUST BE WHY I'VE ALWAYS HEARD ABOU, 
'NATURAL-HIGHS' FROM YOU GUYS?). ANYHOW, AS I REMEMBER IT, IT GOES SOMETHING 
LIKE THIS: YOU RETRIEVE YOUR LUGGAGE AT LAX (L.A. AIRPORT), IGNORE THE TAPE 
RECORDING (24 HRS. A DAY) WHICH REPEATS, "THE WHITE ZONE IS FOR THE IMMEDIATE 
LOADING AND UNLOADING OF PASSENGERS ONLY, NO PARKING !!!", THEN GO AND SEDUCE 
A SIX-FOOT BLONDE LADY WHO WILL ONLY HAVE TO LEAVE WHEN THE U.S.C.'TROJANS' OR 
THE U.C.L.A.'BRUINS' NEED THEIR POM-POMS SHAKEN... NO BIG LOSS... A FLORIDA 
ORANGE (THOSE ARE THE GOOD ONES) HAS AN EQUAL BRAIN, AND FOR THOSE TIMES WHEN 
YOU THINK ABOUT THE YEARS TO COME, YOU'LL REALIZE THAT SOMEONE OTHER THAN HER 
WILL HAVE TO BE THE MOTHER OF YOUR BABIES. THEN IT'S OFF TO SEE THE SIGHTS... 
HIGHLY RECOMMENDED: SEE THE SIGHTS FROM YOUR AIRPLANE AS IT IS LANDING ! WHAT 
NEXT; A VISIT TO LAS VEGAS PERHAPS; I USED TO WORK THERE (REALLY !!!) - PERHAPS 
NOT !!! SO A QUICK FLIGHT TO SAN FRANCISCO (CALL IT 'FRISCO)... HIGHLY RECOM- 
MENDED FLY PSA (A MOST VALUABLE INSIGHT FOR NEWCOMERS), THE HOSTESSES (CALL 
THEM 'STEWS') ARE A DELIGHTFUL CHANGE OF PACE !! SO THEN IT'S BACK TO 'BIG-TOW? 
WEST (L.A.)"' FOR A HOLIDAY VISIT WITH THE OLD FAMILY (THEY MOVED TO PARADISE 

A LONG WHILE BACK)... YOU KNOW WHAT THEY SAY ABOUT GOOD FENCES MAKING GOOD 
NEIGHBORS... I FEEL THAT WIDE CONTINENTS BREED CLOSE FAMILIES !!! WELL THE REST 
OF THE STORY WOULD BORE YOU, HOWEVER IF YOU EVER SEE A FILE ON SOME YET-TO-BE- 
RELEASED DISK CALLED, 'FONENUMS.ZOS', YOU GUYS IN THE SOUTHWEST WILL HAVE JUST 
HIT THE MOTHERLODE; BUT TOO MUCH OF A GOOD THING CAN DULL THE SENSES, SO IT'S 
BACK HOME FOR ME, AND THIS COLUMN FOR YOU... 


kkk PETTY GRIPE DEPT. *** 


BITCH, BITCH, BITCH !!! SOME PEOPLE ARE JUST INCAPABLE OF BEING CONTENT. NO 
SOONER THAN I HAD FINISHED MY REPLY TO ALL OF THE TTY PEOPLE (VOLUME 13.21), 
TONY INFORMED ME THAT SOME VDM OWNERS HAD TROUBLE READING MY 80 CHARACTER 
LINES ON THEIR QUAINT I/O DEVICES. I WILL NOT ACCOMODATE YOU, AND HERE'S WHY: 
I PAID GOOD BUCKS FOR THE TOOLS I USE, AND I CHOOSE TO USE THEM. FRANKLY, I 
CAN'T FATHOM WHY ANYONE WOULD ADMIT TO OWNING ONE OF THOSE THINGS AT ALL. I'VE 
SEEN WHAT YOU GUYS ARE UP TO: THOSE HORRID, NARROW LITTLE PROGRAMS WRITTEN IN 
PROCESSOR TECHNOLOGY'S 5K BASIC (YOU KNOW THE ONES WITH A LINE FOR EVERY SINGLI 
LITTLE THING - 15 DECWRITER PAGES JUST TO PRINT YOUR VERSION OF WUMPUS [ABOUT 
WHICH I SHALL BE HEARD FROM LATER]). YOU GUYS HAVE EXPOSED YOURSELVES TO CAT- 
ARACTS AND MYOPIA BY LOOKING AT YOUR VDM'ED TVS. LEAVE ME OUT OF IT !!! THE 
COMPANY WHO SUPPLIED THOSE B & W CRAYON BOXES TO YOU IS A PLACE TO SUSPECT... 
SEMI-KITS, 8K BASIC THAT WILL BE READY IN 1976 AND ENOUGH ADVERTISING TO EN- 
SURE YOU WILL HAVE PAID TOO MUCH FOR YOUR 'SOL'; ANOTHER MITS I THINK... OH 
WELL, ON WITH THE REVIEW; THIS TIME AROUND WE HAVE A NEW PROBLEM TO CONTEND 
WITH... HARDWARE SENSITIVE ITEMS... ONE PROGRAM 'ROCKET.ASC' REQUIRED INPUT 
ON PORT 02 TO WORK; THIS BOMBED ME OUT. SEVERAL OTHERS SLIPPED THROUGH MY 
OVERWORKED FINGERS BECAUSE THEY ASSUMED PORT 01 (WHICH AGREES WITH MY SET-UP). 
IF ANY OF THESE DON'T RUN FOR YOU (AND IF YOU HAVE ENOUGH MEMORY), THE CUL- 
PRIT IS LIABLE TO BE AN 'INP', OUT' OR 'WAIT' STATEMENT THAT IS NOT CONFIG- 
URED FOR YOUR MACHINERY... 


BLKFRI3.A8C GAS 
THIS IS ONE YOU'VE SEEN BEFORE (VOLUME 5.7). BUT YOU HAVEN'T SEEN IT RUN 
QUITE AS WELL BEFORE. MY HAT'S OFF TO WHOEVER DID THE TOUCH-UPS 1!!! 


DANNER. DSL ff J, e ET Bgvve’~ 

THIS IS A CLEVER LITTLE NUMBER THAT PRINTS HUGE MESSAGES. SOME OF THE CHARAC- 
TERS ARE PRINTED QUITE WELL, AND OTHERS (ONES REQUIRING DIAGONALS) NOT SO 
WELL. THE FIX WILL NOT BE EASY. IN ANY CASE WHAT DOES ONE DO WITH A ‘BANNER! ? 


cuEess.ast GWS 
THIS PLAYS AT LEAST PART OF A CHESS GAME... YOU ARE ASKED WHETHER YOU WISH 

@ 70 BE BLACK OR WHITE; IF YOU REPLY 'WHITE', YOU WILL DISCOVER THAT NO LOGICAL 
CHESS NOTATION WILL BE ACCEPTED; IF YOU REPLY 'BLACK', THE PROGRAM WILL THANK 
YOU FOR YOUR GENEROSITY AND PRODUCE ENDLESS DATA TABLES ON YOUR CONSOLE. THERE 
ARE NO INSTRUCTIONS, AND THE SOURCE IS CONSIDERABLY SHORTER THAN THAT OF ANY 
OTHER (BASIC) CHESS GAME (AND THE ONES I'VE SEEN ARE ABYSMAL) WHICH I HAVE YET 
TRIED. PERHAPS SOMEONE IS GETTING AN EARLY JUMP ON APRIL FOOLS' DAY. 


BIO. BSE KAS 

ANOTHER BIORHYTHM PLOTTER... THIS ONE PAGINATES AND FLAGS 'CRITICAL DAYS'. 
AT THE HEADING OF EACH PAGE YOU WILL BE ENTREATED TO CALL 'ELMER'; A PHONE 
NUMBER WITHOUT AREA CODE IS SUPPLIED. I SUSPECT THAT ONE IS TO CALL ELMER 
TO COMMENT ABOUT THIS PROGRAM. I SUGGEST INSTEAD THE FOLLOWING NUMBER TO 
CALL WITH YOUR COMMENTS (IF YOU REALLY MUST): 505 243-7821. FOR THOSE WHO 
DO NOT RECOGNIZE THIS NUMBER, IT IS ONE OF MITS' (UGH !!) MAIN HOT-LINES; 
AND FOR THOSE WHO DO NOT RECOGNIZE THE PROGRAM, IT BEARS MORE THAN A CASUAL 
RESEMBLANCE TO ONE OF THE 'FREEBIES' THAT IS INCLUDED WITH THE DISK BASIC 
WHICH MITS (RETCH !!) DISTRIBUTES. 


ACYDUCY.aAStC OPTS 

THE ALL-TIME SUCKER'S GAME REVISITED. THIS IS ONLY AN APPROXIMATE SIMULATION 
THERE ARE NO MARKED CARDS, NO CROOKED DEALERS, NO SHILLS AND NOBODY WEARING 
A STOCKING MASK, CARRYING A SAWED-OFF SHOTGUN WILL RELIEVE YOU OF YOUR BANK- 
ROLL. SOUNDS DULL, N'EST-CE PAS ? I WOULD BE MOST SURPRISED IF FAIRCHILD OR 
ATARI EVER PRODUCES A GAME CARTRIDGE FOR THIS. 


MAZE.A8C Oh f 

C+] GUESS WHAT THIS ONE DOES ? IF YOU AREN'T SURE, RUN IT. BEFORE IT HAS ‘'DONE 
ITS THING', YOU WILL HAVE HAD PLENTY OF TIME TO FIGURE IT OUT. THIS SEEMS 
TO NEED LOTS OF MEMORY (NOT TO MENTION PATIENCE), AND I HAVE YET TO SEE ANY- 
ONE DO ANYTHING WITH ONE OF THESE ONCE THEY ARE PRINTED. RATHER THAN HAVE 
SEVERAL FEET OF PAPER WITH A SILLY MAZE (OH, RATS, I GAVE AWAY THE SECRET), 
I WOULD PREFER A JAGGED LINE WHICH REPRESENTED THE CORRECT PATH THROUGH THE 
MAZE WHICH NOBODY BOTHERED TO PRINT. COME ON GANG, I WANT THE ABSOLUTE TRUTH; 
HAS ANYONE EVER TRIED TO SOLVE ONE OF THESE THINGS ? 


MANDALA.ASC OkJ 

YOU HAVE JUST MORTGAGED EVERYTHING YOU OWN SO YOU COULD FINALLY HAVE YOUR OWN 
COMPUTER. WHAT BETTER WAY TO GET OFF THE GROUND THAN TO PRODUCE RELIGIOUS 
ARTIFACTS. A MANDALA IS (I'M SURE YOU WEST-COASTIES KNOW THIS ALREADY) SOME- 
THING ON WHICH ONE CONCENTRATES WHILE LEARNING TO MEDITATE. THE ROAD TO INNER 
PEACE IS A LONG, HARD JOURNEY AND THE TRAVEL IS VERY SLOW INDEED. IN THIS RE- 
GARD, THIS PROGRAM IS PERHAPS THE MOST ACCURATE SIMULATION WHICH HAS EVER BEEN 
ATTEMPTED. BEFORE THIS PROGRAM DELIVERS THE ARTWORK, IT ASKS SOME STRANGE AND 
MYSTERIOUS QUESTIONS. WHAT DO THEY REALLY MEAN ? AS THE DIVINE GURU SO APTLY 
PUT IT: "THE FACE OF TRUTH WEARS MANY MASKS...". 


DIAMONDS.ASC kJ 

THIS PRINTS DIAMOND SHAPED PATTERNS WHICH SHAMELESSLY SLOGANEER ON BEHALF 

OF THE DIGITAL EQUIPMENT COMPANY. THIS TYPIFIES SO MUCH OF THE STUFF WHICH 

COMES TO US IN THE MAIL; GOOD EXECUTION OF BANAL IDEAS. SINCE THIS WAS PIL- 

FERED FROM THE DECUS LIBRARY, I HAVE SLEPT EASIER KNOWING THAT I BOUGHT AN 
Oo IMSAI INSTEAD. IF DIAMONDS REALLY ARE A GIRL'S BEST FRIEND, THEN I SUBMIT 
THAT WOMEN'S LIB CAME ABOUT A CENTURY TOO SOON (PERHAPS THE VERY POINT OF 

THIS PROGRAM). 


KING. psc 04S 

THE DREADED 'KINGDOM' GAME AGAIN... FAMINE, PLAGUES, PESTILENCE, ILLITERACY, 

RAMPANT SOCIAL DISEASES ETC. YOU ARE THE KING OR QUEEN OF THIS BLIGHTED WIL- 
20642 DERNESS, AND YOU CAN ONLY WIN THIS GAME IF YOU SPEND YOUR PRECIOUS 'RALLODS! 


FUR THE BBwWEbrit Yo LURK stUsBa © SP5u Wide KRitisoObA, dildo Le Uri A UIMPULORN 
GAME (BARELY A COMPUTER GAME). WINNING ISN'T EVERYTHING !!! LET YOUR UNWASHED 
SUBJECTS FEND FOR THEMSELVES. ADMIT THAT YOUR HEART REALLY WASN'T IN YOUR 
MONARCHY. TAKE ALL OF YOUR RALLODS TO SOUTH AMERICA AND ENJOY YOURSELF (YOU 
CERTAINLY WON'T ENJOY YOURSELF HERE). 


| ‘TRADE.ASC JM { 

re) THIS IS THE 'STARTRADER' (ALSO KNOWN AS 'STARLANES' - VOLUME 3.25) GAME. A 
FUN ALBEIT SOMEWHAT CONFUSING PASTIME. THIS ONE ALSO HAS INSTRUCTIONS WHICH 
AUTOMATICALLY MAKES IT A VAST IMPROVEMENT OVER THE ONE WE RECEIVED EARLIER; 
AND IF YOU RECALL I LIKED THAT ONE ALSO. 


TAXMAN. ASC J 4 f 

WHAT IN THE HELL IS THIS THING ? DESPITE THE CATCHY NAME, IT HAS NOTHING TO 
DO WITH TAXES. IT'S YOU VS. THE COMPUTER IN A GAME OF NUMBER FACTORING. TO 
WIN YOU WILL PROBABLY NEED YOUR POCKET CALCULATOR. IN MY OPINION IT ISN'T 
WORTH TYING UP YOUR CALCULATOR (NOT TO MENTION YOUR COMPUTER) FOR THIS. 


APOLLO.ASC 6 AJ 

THIS YOU WILL PROBABLY WANT TO RUN JUST ONCE (CRT'S ONLY - SUGGESTED 4800 + 
BAUD); BUT IT'S CLEVER, AND THERE IS A CUTE SURPRISE HERE. I WON'T SPOIL 

IT FOR YOU. YOU PATRIOTS MAY WISH TO REPLACE 'APOLLO - U.S.A.' WITH SOME- 
THING LIKE 'SOYUZ - C.C.C.P. 


HORSE.ASC OR 
THIS IS A FUN HORSE RACE SIMULATION. TONY MADE ME PROMISE NOT TO TOUCH ANY 
OF THESE GAMES, OTHERWISE I WOULD HAVE CERTAINLY DONE MY NUMBER ON THIS ONE. 
WHAT I WOULD HAVE DONE FOR YOU IS: 1) CLEAN UP THE FORMATTING, 2) REARRANGED 
THE INPUTS FOR SINGLE DATUM ENTRIES (LESS ERROR PRONE THAN 4 ENTRIES SEPAR- 
ATED BY COMMAS), 3) ADDED MORE HORSES (THE SAME OLD NAGS GET TIRED - TIRING 
AS WELL) AND 4) CORRECTED THE TOTE BOARD FOR 'TRACK-FORMAT!' (EVERY PAYOFF 
ROUNDED TO NEXT LOWEST $0.20 AND NEVER LESS THAN $2.20 - AS IF THEY DIDN'T 
ROB YOU BLIND ENOUGH ANYWAY). THESE WOULD HAVE RESULTED IN A VAST !! IMPROVE- 
re) MENT (MAYBE NEXT TIME). FOR YOU SOFTWARE HACKERS (BEGINNERS ESPECIALLY), THE 
IMPROVEMENTS I MENTIONED WOULD BE REALLY EASY TO IMPLEMENT, AND THE RESULTS 
WELL WORTH THE MINIMAL EFFORT !1!! 


TRAP. AST WS 

AH HAH ! THE INFAMOUS NUMBER TRAPPING GAME AGAIN (VOLUME 13.19). I SUGGEST 
THAT YOU READ MY REVIEW OF THIS PROGRAM (VOLUME 13.21). I DIDN'T HAVE ALL 
THAT MUCH TO SAY ABOUT THIS THEN, BUT THE REST OF MY REVIEW WAS WELL WORTH 
THE PRICE OF THE DISK. 


ENTE/ENTEP.asc 4 43 ; 
THESE GUYS DRAW YOUR FAVORITE (NOT MINE !!!) SPACESHIP. HIGHLY RECOMMENDED FOR 
TTYS (IN WHICH CASE THE RUN WILL BE PAINFULLY SLOW) AND VDMS (SEE, I'M NOT AT 
ALL HARD TO GET ALONG WITH). : 


RUSSIAN. asc 54) 

IF YOU RECALL, A PROGRAM OF THE SAME NAME (VOLUME 13.16) DESERVEDLY RECEIVED 
THE VERY WORST REVIEW THAT I WAS CAPABLE OF WRITING. THIS VERSION IS SO MUCH 
BETTER THAT I CANNOT BRING MYSELF TO BE UNKIND. THE UNDERLYING IDEA IS STILL 
TRIVIA IN THE WORST OF TASTE, BUT THIS TIME IT WAS DONE RIGHT. 


ROCKET. ase 

LANDER.aAsSe 6 

I'LL BET YOU'VE SEEN THESE BEFORE, AND SADLY I'LL PROBABLY SEE THEM AGAIN ALSO. 
THEY ARE INCLUDED IN THIS VOLUME TO FILL SPACE (OUTER SPACE). 


© Furs.asc O& $ 


UNDER WHAT STRANGE INFLUENCES WAS THIS ODDBALL ITEM CONCEIVED ? THIS RIVALS 
'"KINGDOM' FOR A PLACE NEAR THE BOTTOM OF THE HEAP. BRIEFLY, ONE IS TO TRADE 
PELTS (FOUR KINDS) IN NEW YORK OR CANADA. THERE ARE THREE TRADING POSTS; TWO 
ARE DEFENDED BY THE FRENCH ARMY, AND ONE BY THE DUTCH. HOSTILE WEATHER AND 
INDIANS ARE IMPLIED. IN THIS NONSENSICAL RECREATION OF HISTORY, THE FRENCH 
2502/3 ARMY IS CAPABLE OF BEING A FORMIDABLE OPPONENT... BACK TO THE HISTORY BOOKS, 


WHOBVER WROTE THiS .. Ll HAVE BY NUW b27hnN1l MURS aszarls fata wo ADJ 4 Lido tna 
I SPENT THE ONE TIME (TOO MANY) I PLAYED IT. 


snoopysise 547 

THIS ONE DRAWS PICTURES OF THAT DARLING LITTLE DOG FROM THE 'PEANUTS' COMIC 

STRIP; YOU KNOW THAT LOVEABLE POOCH THAT SAYS ALL THOSE CLEVER THINGS, AND 

PLAYS ICE-HOCKEY WITH THAT ADORABLE LITTLE BIRD. SOMEDAY, I'LL FIND OUT JUST 
Qo ™ ALL-AMERICAN TOWN SNOOPY LIVES IN, AND WHILE HE'S DOING SOMETHING CUTE 

ON THE ROOF OF HIS DOGHOUSE, I'LL PUT CYANIDE IN HIS FOOD. HEH, HEH !!! 


BLKIK.A8C 6&3 

THIS PLAYS BLACKJACK (FOR THOSE WHO DON'T KNOW BETTER, THE 'IN' NAME FOR THIS 
GAME IS '21', AND HAS BEEN SINCE LEGAL GAMBLING HIT NEVADA). MOST REMINISCENT 
OF THE ONE FROM VOLUME 13.6. THE GAME IS NICE; THE FORMATTING'S HORRID, THAT'S 
WHAT I SAID LAST TIME, AND IT'S STILL TRUE. 


CHASE .ASC Shy 

ELECTRIFIED POSTS, HIGH-VOLTAGE WALLS AND DEATH-DEALING ROBOTS... HOW DID YOU 
GET INTO SUCH A PREDICAMENT ? AN ABOVE AVERAGE GAME, BUT AFTER SEVERAL TRIES, 
IT BECOMES EVIDENT WHETHER OR NOT YOU WILL WIN BY EXAMINING THE STARTING PO- 
SITION. THIS GAME IS A FAVORITE WITH THE YOUNGSTERS (SINCERE COMPLIMENT). IT 
WILL REMIND YOU OF A GAME BY THE SAME NAME (VOLUME 3.10). 


STRTRKA2.ASE OKI 
THIS ONE IS A GEM IN SEARCH OF INSTRUCTIONS. SINCE I HAVE HAD A CHANCE TO PLAY 
WITH THIS, I WILL TELL YOU ENOUGH TO AT LEAST GET YOU STARTED. TO FAMILIARIZE 
YOURSELVES WITH THE COMMAND-TABLE, ENTER A ZERO €CR> WHEN GIVEN THE ‘COMMAND ?: 
PROMPT. WHEN IN THE 'COMPUTER' MODE, ENTER A NINE &CR WHEN PROMPTED WITH ‘COM 
PUTER ON COMMAND ?'. IT IS HIGHLY RECOMMENDED THAT YOU ENTER THE APPROPRIATE 
COMMAND TO PRINT THE 'WARP-COMPASS' BEFORE YOU TRY TO PLAY THIS; THE REASON 
BEING THAT IN THIS VERSION OF STARTREK, ONE NAVIGATES COURSES OF 0-359 DEGREES 
THOSE COURSES (0-359), AND ALSO THE PHOTON TRAJECTORIES ARE WHERE YOU WOULD 
LEAST EXPECT TO FIND THEM, THE MAJOR LIMITATION OF THIS IS THAT IT WAS MADE TO 
@ on In 32x (WITH 3.2 MITS BASIC). I PERSONALLY WOULD HAVE LOVED TO HAVE SEEN 
WHERE IT WOULD HAVE GONE IF THE AUTHOR(S) HAD OWNED MORE MEMORY. 


STRTRK¥3 . ASC OMI 

THIS IS ANOTHER STARTREK. THERE ARE NO INSTRUCTIONS, AND THE AUTHOR IS NOT 
AFRAID TO ADMIT THAT (RUN IT, YOU'LL SEE WHAT I MEAN). THIS IS REALLY A SHAME 
BECAUSE IT LOOKS LIKE IT MIGHT BE VERY GOOD. BUT, WITH EACH MOMENT AT SUCH A 
PREMIUM THESE DAYS, I JUST COULDN'T SPEND ENOUGH TIME WITH THIS TO DETERMINE 
HOW TO PLAY IT PROPERLY. IN ANY EVENT, I'M SURE THAT EVEN WITH MORE INFO ON 
HOW TO DO EVERYTHING RIGHT, I WOULD STILL PREFER 'STRTRK/2'. 


WARI.ASC GAT 

THIS IS ONE OF SEVERAL RENDITIONS OF 'WARI' (A.K.A. 'AWARI', 'KALI' ETC.) 
WHICH I HAVE SEEN. THIS ONE IS THE BEST, DESPITE THE FACT THAT THERE ARE 

NO INSTRUCTIONS (THEY CAN BE FOUND IN SEVERAL BOOKS AND SOFTWARE ARTICLES) . 
LIKE ALL OTRER (BASIC) VERSIONS I'VE SEEN EARLIER, THIS TAKES FAR TOO LONG 
TO MAKE ITS (COMPUTER'S) MOVE. IF YOU'RE A PATIENT SORT YOU WILL ENJOY THIS, 
OTHERWISE IT WILL LIKELY BE ONE OF THE FIRST ONES YOU ERASE. 


W/SEARCH.asG $41 

THIS GENERATES WORD-SEARCH PUZZLES. IT DOES SO QUITE WELL. THERE ARE QUITE 
A FEW UNEXPECTED SURPRISES (ALL PLEASANT FOR A CHANGE). AND I HAVE YET TO 

SEE THIS PROGRAM MAKE ANY MISTAKES (HOW OFTEN DO YOU HEAR ME SAY THAT ?). 


wump.ast S*Y 

oO AS SOME OF YOU MAY HAVE SURMISED, I AM NOT FOND OF 'WUMPUS' GAMES. IN FACT, 

Mw I'VE ASKED QUITE POLITELY (TWICE) THAT PEOPLE REFRAIN FROM SENDING THESE 
TEDIOUS ATTEMPTS TO TONY... PERHAPS YOU DON'T UNDERSTAND HOW THIS OPERATION 
WORKS... LET ME EXPLAIN: TONY HATES COMPUTER GAMES; HE WILL NOT RUN THEM 1! IT 
DOES NOT MATTER TO HIM IF I SAY THAT A CERTAIN PROGRAM IS A LOSER; SINCE HE IS 
NOT FAMILIAR WITH ANY OF THESE GAMES, HE TELLS ME TO REVIEW THEM ANYWAY. PER- 
HAPS HE FEELS THAT JUST BECAUSE I SAY THAT A CERTAIN PROGRAM IS LIKE A CRETIN'S 

24S°2/YNTGHTMARE, SOME OF YOU KIND FOLKS MIGHT NOT AGREE — A REASONABLE ENOUGH STANCE, 


BUT MARKS NU Miolars -- - aAN Da UNIS tf L CUNUUbSG; ANS IU) Pass Aas AM YW ID 
MITTING THESE STAND TO SUFFER MIGHTILY FOR YOUR DISOBEDIENCE !!! YOU DO PUT RE 
TURN ADDRESSES ON YOUR 'WUMPUS' DISKS, DON'T YOU ? WELL MR. WISEGUY, WHO CON- 
TRIBUTED THIS BORING !! REHASH, JUST FOR YOU, ONE FINAL REVIEW OF YOUR AWFUL 
'WUMP' PROGRAM: I CAN'T BELIEVE THAT PERSONS BRIGHT ENOUGH TO BREATHE WOULD 
BE EVEN MOMENTARILY ENTERTAINED BY SUCH MORONIC EXCESS. HOWEVER YOU, SIR, HAVE 
PROVEN ME WRONG !!! IT TAKES ALL KINDS, AND ONE MUST BE TOLERANT, BUT I WOULD 
te) RATHER SPEND 1000 YEARS IN LUCIFER'S FIRES THAN ONE EVENING IN THE COMPANY OF 
YOU AND YOUR OBVIOUSLY UNDER-UTILIZED COMPUTER. TO ANYONE ELSE (BUT YOU) WHO 
MIGHT READ THIS, ALTHOUGH WUMPUS GAMES STINK; THIS IS MORE DESERVING THAN MOST 
OTHERS OF BEING RUN AT LEAST ONCE. I HOPE YOU WILL ENJOY THE NUMEROUS MISSPEL- 
LINGS AND THE PIDGIN-ENGLISH TO BE FOUND IN THIS 'GAME', THESE ARE FAR AND AWA} 
THE BEST PARTS. P.S. TONY, THAT'S IT !!! IF YOU ASK ME TO DO EVEN ONE MORE 
'WUMPUS' REVIEW I'LL QUIT (I MEAN IT) !!! 


TACOS.ASE OfyJ 
AS I MENTIONED, I JUST RETURNED FROM CALIFORNIA. MY FRAIL EGO WAS REINFORCED 


TWICE... THOUGH I HAD LITTLE USE FOR BUSINESS, I DID VISIT CONVENIENT 'HOME 
COMPUTER' OUTLETS. IMAGINE MY HAPPY SURPRISE WHEN I HEARD MYSELF DISCUSSED 
TWO TIMES !!! ONE NAMELESS PLACE IN THE BAY AREA WAS MOST CORDIAL TO ME; AND 
WHEN I POSED AS A CUSTOMER, SEEMED MOST POLITE... THEY EVEN SHOWED ME MY VERY 
FIRST COLUMN (VOLUME 3A.DOC), AND TOLD ME THAT IF I WOULD BUY FROM THEM, STUFF 
SUCH AS I WRITE, WOULD BE READILY AVAILABLE TO ME... THANKS A LOT !!! I CAN 
GET IT WHOLESALE (AS WE SAY HERE). IN LOS ANGELES, I HAD QUITE A DIFFERENT 
EXPERIENCE; TWO FELLOWS WHO HAD NO IDEA TO WHOM THEY WERE SPEAKING LET ME IN 
ON THEIR NEFARIOUS LITTLE PLOT... THE IDEA WAS TO SUBMIT THIS ITEM TO ZOSO SO 
AS TO GIVE ME YET ANOTHER OPPORTUNITY TO BE UNKIND... WELL, NO WAY !!! OF 
COURSE THIS PROGRAM IS LOUSY, BUT GENTLEMEN OF THE (STORE NAME DELETED), IF 
YOU REMEMBER, I ALSO SAW THE OTHER STUFF YOU RUN (WHICH YOU HAVE NOT YET SEEN 
FIT TO CONTRIBUTE), AND AS FAR AS I'M CONCERNED, THIS IS AS GOOD OR BETTER !!! 


* *** CONTEST NEWS ETC. *** 


THE CONTEST IS STILL ALIVE !!! WHEN I DECIDE THAT I HAVE FINALLY GOTTEN JUST 
WHAT I WANTED, I WILL ANNOUNCE THE WINNER... NOT YET !!! THE VERY FEW ENTRANTS 
HAVE ALL SUGGESTED IDEAS (OH YES, READ ABOUT THE FAMOUS CONTEST WHICH I AM 
SPONSORING IN VOLUME 13.21) WHICH INVOLVE MUTILATIONS OF MY C/BIOS. THIS, I 
COULD HAVE HANDLED MYSELF. I WANT A CP/M INDEPENDENT ROUTINE WHICH WILL TRULY 
RANDOMIZE MICROSOFT'S DISK BASIC. REFERRING AGAIN TO MY LAST COLUMN, I LAMENTE! 


THAT TDL HAD NOT ISSUED A DISK BASIC... NO LONGER TRUE !!!... THEY HAVE SOME 
OF THE VERY BEST CP/M STUFF AVAILABLE, WHAT GOOD DOES THAT DO YOU ?... NONE AT 
ALL !!! IT WON'T MATTER WHAT YOU SAY WHEN YOU CALL THEM, THEY WILL DENY THE 


EXISTENCE OF THE VERY BEST SOFTWARE YOU Z-80 TYPES (I AM ONE) MAY EVER SEE. I 
HAVE IT ALL (EXCEPT FOR MICRO-SEED), BUT THAT WON'T HELP ANY OF YOU... PLEASE 


GET IN THE HABIT OF USING THE FILETYPE ' ASC' FOR STUFF WRITTEN FOR MICROSOFT 
BASIC AND '.BAS' FOR BASIC-E AND C-BASIC. SPEA G OF THESE TWO SPLENDID COM- 

R BASICS; *. INT? FILES ARE STILL BEING SOLD... WHEN YOU READ THAT SOME EX- 
PENSIVE ITEM IS 'WRITTEN IN C-BASIC', THAT COLD CHILL YOU FEEL IS MERELY YOUR 
SELF-PRESERVATION INSTINCT TAKING OVER... 


HAPPY VALENTINE'S DAY 


ZOSO 


2S.” 


POLY-vuU 
#PVIID 


K&M Company 
TORRANCE, CA 90503 


en) 


o 


-CATALOG022 
BIGTREK ASC 
BIGTREK BAS 
STARTREKTXT 
STRTRK/ 2ASC 
TREK INFODOC 
TREKMOD ASC 


Z0SO 


22 


8 file(s). 


46 directory entries 


D>STAT O: 


Bytes Remaining On O: 24k 


D>TYPE O:-CATALOG.022 
VOLUME 22 


MONSTEROUS STARTREK GAMES 


remaining. 


CPMUG vol. 22 OFT BO 


WELL DOCUMENTED GAMES FOR MEMBERS WITH LOTS OF 


MEMORY 


NUMBER SIZE 


22.1 


22.2 
22.3 


22.4 


22.5 
22.6 


D> 


48K 


39K 
54K 


21K 


5K 


42K 


AND LOTS OF TIME 


NAME 


CATALOG. 22 
ZOSO.22 


BIGTREK.ASC 


BIGTREK.BAS 
STARTREK.TXT 


STRTRK/2.ASC 


TREKINFO.DOC 


TREKMOD.ASC 


COMMENTS 


CONTENTS OF CP/M GROUP VOL 22 

DESCRIPTION AND APPLICATION NOTES 

ON THE PROGRAMS BY ZOSO AND EDISON DOGGE 

22.3 TRIMMED TO LOAD UNDER TDL DISK BASIC 

WITH 64K MEMORY 

COMPACTED VERSION OF 22.1 FOR MUCH FASTER LOAD 
STARTING POINT OF BIGTREK. PURPORTED TO WORK 
WITH 8K BASIC. UNFORTUNATELY LARGER INTERPRETERS 
LEAVE INSUFFICIENT MEMORY FOR PROGRAM. CONTAINS 
THE AUTHOR CREDITS. 

A SECOND APPEARENCE OF PROGRAM 21.21 WHICH ZOSO 
INCLUDED FOR IMPROVEMENT HINTS FOR SERIOUS 
TREKKIES WHO DON'T HAVE VOLUME 21 

DETAILED RULES AND FEATURES OF STARTREK.TXT AND 
BIGTREK 

BIGTREK TRIMMED SOME MORE AND ABLE TO LOAD WITH 
MICROSOFT DISK BASIC 


TYPE O:Z05U0.42 


STARTREK. TXT 


BIGTREK.ASC 


BIGTREK.BAS 


TREKINFO.DOC 


TREKMOD.ASC 


on™’ 2.ASC 


NO MATTER HOW YO 
60K IF YOU USE 8 
WITH TDL DISK BA 


SINCE I CAN RUN 
MICROSOFT DISK B 
BE TO PARTITION 
THE LINES RELATI 
TABLES AND ALL B 
ENCED AFTER GAME 
OTHER MODULE, 'S 
(TO BASIC) IN 'S 


THIS DISK CONTAINS THE FOLLOWING FILES: 


THIS IS THE ORIGINAL SOURCE FILE FROM WHICH THIS PACKAGE WAS 
DEVELOPED. IT IS PURPORTED TO RUN AS IS WITH MITS 8K BASIC. IT 
CONTAINS ALL THE REMARKS, AUTHOR CREDITS ETC. IF YOU HAVE THIS 
BASIC WITH ASCII-LOAD CAPABILITY, TRY IT !! 


THIS IS THE RESULT OF HAVING TRIED TO TRIM THE ABOVE SOURCE SO 
AS TO GET IT TO RUN (IN A 64K SYSTEM) WITH MICROSOFT'S MBASIC. 
IT PRESENTLY IS ALMOST SHORT ENOUGH, BUT NOT QUITE. BECAUSE OF 
THIS, THE OBJECTIVE BECAME TO MAKE IT SUITABLE FOR TDL'S DISK 
BASIC RUNNING IN 64K. IT RUNS QUITE NICELY THAT WAY. ALL OF THE 
FEATURES OF THE ABOVE PROGRAM ARE RETAINED, AND A COUPLE OF NEW 
ONES HAVE BEEN IMPLEMENTED. 


THIS IS THE COMPACTED MACHINE CODE OF THE ABOVE FILE WHICH 
LOADS ABOUT 50 TIMES FASTER THAN THE ASCII VERSION (TDL DISK 
BASIC ONLY). THE PROPER STEPS TO LOAD THIS ARE AS FOLLOWS : 
(ASSUME YOU HAVE LOADED TDL BASIC INTO A 64K SYSTEM)... 


1 - OPEN#1,"I","BIGTREK.BAS" <CR> 
2 - LOAD "B" <CR> 
3 - CLOSE#1,"I" <CR> 
4 - RUN <CR> 


A BRIEF TUTORIAL ON THE RULES FOR PLAYING THIS, CROSS-REFER- 
ENCED WHERE POSSIBLE WITH THE FAMILIAR COMMANDS OF THE MORE 
COMMONLY AVAILABLE 'STARTREKS'. 


SEE EXPLANATION (IN POST-SCRIPT). 


THIS IS INCLUDED BECAUSE I LIKE THE 'COMMUNICATIONS' AND 'MIS- 
SION~PROGRESS-REPORTS' THAT HAVE BEEN IMPLEMENTED IN THIS MUCH 
SMALLER (STILL > 20K) VERSION. 


U GO WITH THIS, IT IS LIKELY THAT YOU WILL NEED 64K (PERHAPS 
K BASIC) TO RUN IT AT ALL. ONLY GUARANTEE IS THAT IT WILL RUN 
SIC/64K AS IS. 


THIS, I LEAVE IT TO SOMEONE ELSE TO GET IT WORKING WITH EITHER 
ASIC (OR BASIC-E). ONE SUGGESTION FOR THE FORMER PROJECT MIGHT 
THIS PROGRAM INTO TWO MODULES. THE FIRST WOULD CONTAIN ALL OF 
NG TO GALAXY INITIALIZATION, DIMENSIONING STATEMENTS, DATA- 
EGINNING OF GAME DIALOGUE - IN OTHER WORDS, LINES NOT REFER- 
IS IN PROGRESS. THIS FILE MIGHT BE CALLED 'STARMOD1.ASC'. THE 
TARMOD2.ASC' WOULD CONTAIN EVERYTHING ELSE. THE LAST COMMAND 
TARMOD1.ASC' WOULD BE: MERGE"STARMOD2.ASC". BOTH MODULES WOULD 


HAVE TO BE RENUMBERED IN SUCH A WAY THAT AT THE BEGINNING OF THE 'MERGE', EACH 


NEW LINE OF 'STA 
LINE NUMBER (UNT 
FROM SECOND MODU 
A PLAYER REPLIED 
BE MADE TO A LIN 
UTION IS A BIT ' 
'P.S.' BELOW; TH 
OF SUCH (ABOVE-M 
MR. DOGGE ENCOUN 
ITH (THE TYPICA 


LATE NOTE: THE 


RMOD2' WOULD WIPE OUT A LINE OF 'STARMOD1' WHICH HAD THE SAME 
IL EVERY LINE OF FIRST MODULE WAS OVERWRITTEN BY A NEW LINE 
LE). ONE CHANGE WOULD BE NECESSITATED IN THE SECOND MODULE: IF 
‘y' TO THE QUESTION, 'ANOTHER GAME ?' A BRANCH WOULD NEED TO 
E WITH THE FOLLOWING COMMAND, - RUN "STARMOD].ASC", THIS SOL- 
KLUGEY', BUT PERHAPS PREFERABLE TO FURTHER TRIMMING. SEE THE 
E MICROSOFT MANUAL IMPLYS (BY NO PROHIBITION) THE LIKELIHOOD 
ENTIONED) ARTIFICES BEING EFFECTIVE. THE DISAPPOINTMENT THAT 
TERED SHOULD BE ATTRIBUTED TO HONEST EXPERIMENTATION COMBINED 
LLY) INADEQUATE DOCUMENTATION. 


HAVE FUN !!! - ZOSO 


EXPERIMENT WITH MERGING TWO OR MORE MODULES HAS BEEN TRIED. I 


AM SAD TO REPORT THAT THIS APPROACH APPARENTLY DUES NOY WURK. YT S4ofb 4 iA 

THE EFFECT OF THE 'MERGE' FUNCTION IS TO DESTROY DATA (IN ADDITION TO CERTAIN 
LINE NUMBERS). MY THANKS TO MR. E. DOGGE FOR THIS INFO. E.D. ALSO SENT A 'TRIM- 
JOB' OF 'BIGTREK' CALLED 'TREKMOD'; IT PLAYS THE SAME GAME, BUT LACKS THE 'SCO- 
RING' AND 'VISUAL' FUNCTIONS. NOT TO DEMEAN MR. DOGGE'S EFFORT, I CAN'T PER- 
SONALLY SEE HOW THIS PARTICULAR 'STARTREK' CAN BE MEANINGFUL WITHOUT THE SCO- 
RING ROUTINE. IF THIS WERE MY 'BABY', I WOULD (IF NECESSARY) REDUCE EVERY BIT 


@r (TEXTUAL) CONSOLE OUTPUT TO A 2 DIGIT CODE SO AS TO RETAIN 'SCORING'; THE 


Vw 


'VISUALS' ARE CUTE BUT NON-ESSENTIAL. SEE WHAT YOU THINK. ALSO !!! THERE ARE 
(IN THE 'BIGTREK' FILES ONLY) SOME CRUCIAL ERROR TRAPS WHICH I INSERTED. LOOK 
FOR THESE AT THE BEGINNING OF THE 'NAVIGATE' AND 'IMPULSE' SUBROUTINES. THE 
COMMON STARTREK PRACTISE OF INPUTTING A '0' WARP-FACTOR (DISTANCE) TO ABORT 
AN IMPROPERLY ENTERED NAVIGATION ROUTINE WILL, WITHOUT THESE TRAPS, GIVE YOU 
A ‘SUBSCRIPT OUT OF BOUNDS' ERROR, AND THE GAME WILL HAVE BEEN (LITERALLY) 
LOST. I SUGGEST COPYING THESE EXACTLY IF YOU WILL BE TRYING THE 'TREKMOD' IM- 


PLEMENTATION. 


D> 


TYPE Os: TREKINFU,. DUL 
HKKRERKKKEEKERKERERREREK 
**k* PREPARED BY ZOSO *** 


*e* 2, 13, 1978 kee 
KKEEKKEKKKEKKEKKEKKEKEKEKEEREKSE 


HE FOLLOWING DOCUMENTS THE RULES AND OPTIONS OF THE GAMES 'STARTREK.TXT' AND 
'BIGTREK'. 


OBJECTIVE —- UNLIKE MOST OTHER STARTREKS, DESTROYING THE KLINGON FLEET IS ONLY 
A SECONDARY OBJECTIVE; THIS GAME FEATURES A VERY COMPREHENSIVE SCORING ROU- 
TINE, AND THE REAL OBJECTIVE IS TO GET THE HIGHEST POSSIBLE SCORE (NOT UNLIKE 
A PINBALL MACHINE). 


START OF GAME - WHEN THIS GAME SIGNS ON, IT ASKS: "MISSION DURATION ?"; ANSWER 
's', 'M' OR 'L' (SHORT MEDIUM OR LONG). IT IS WORTH NOTING THAT THE SHORT GAMES 
CAN BE VERY, VERY SHORT. NEXT IT ASKS "ARE YOU A BEGINNER, NOVICE, SENIOR OR 
EXPERT; ANSWER 'B', 'N', 'S' OR 'E', ALSO WORTH NOTING, IF YOU REPLY 'B' THE 
GAME STARTS OUT GIVING THE PLAYER MORE INFORMATION THAN IS AVAILABLE IN ANY OF 
THE OTHER THREE MODES. THEN IT REQUESTS YOUR "MISSION PASSWORD"; REMEMBER WHAT 
YOU REPLY HERE; YOU WILL NEED TO KNOW THE WORD TO SELF DESTRUCT (WHICH DUE TO 
THE EMPHASIS ON POINTS SCORED IS OFTEN THE WISEST OPTION). FINALLY YOU WILL BE 
ASKED, "READY TO CONTINUE ?"; ENTER ANY CHARACTER AND HIT RETURN. 


NAVIGATION, PHOTON AIMING ETC. - THE COORDINATES USED ARE JUST EXACTLY LIKE 
THE NUMBERS ON A CLOCK FACE (12 O'CLOCK AT THE TOP) N.B.!!! IF YOU WANT TO 
TRAVEL OR AIM A PHOTON STRAIGHT UP, ENTER COURSE 12 (NOT COURSE 0); FAILURE 
TO OBSERVE THIS PRECAUTION WILL LEAD TO AN OCCASIONAL DIVISION BY ZERO ERROR, 
AND YOU WILL HAVE LOST THE GAME IN PROGRESS. (NOTE - I INSERTED SEVERAL TRAPS 
FOR THIS, BUT I VERY LIKELY MISSED SOME ALSO. Z.) FINALLY IT GOES WITHOUT 
SAYING THAT IF YOU WANTED TO TRAVEL ON A COURSE EXACTLY HALF WAY BETWEEN NOON 
AND 3:00 O'CLOCK, THE CORRECT COURSE WOULD BE 1.5 (NOT 1:30). 


WHAT YOU WILL FIND IN THE QUADRANTS: 


Es THE ENTERPRISE 

K: KLINGON BATTLE CRUISER 

O: ORGANIAN TRUCE-MONITOR VESSEL-SPACE WARPS OFTEN ACCOMPANY THESE. 
(SHOOT THEM JUST FOR PRACTISE). 

C: COMMANDER-MAY BE YOURS, MAY BE ENEMY'S. LONG RANGE SCAN WILL TELL 
YOU WHICH (IF YOU COUNT TOTAL ENEMY IN QUADRANT). 

F: THE FAERIE QUEENE-AN OLD STARSHIP WHICH YOU CAN SOMETIMES USE AFTER 
ENTERPRISE HAS BEEN ABANDONED OR CRIPPLED. 

ms STARS-IF THEY ARE IN YOUR WAY, YOU CAN SHOOT THEM WITH YOUR PHOTONS, 


THERE IS A MINOR PENALTY FOR THIS. (THEY 'NOVA' WHEN DESTROYED.) IF 
YOU ARE TOO CLOSE TO A STAR WHEN YOU SHOOT IT, THE FORCE OF THE NOVA 
MAY WELL DESTROY THE ENTERPRISE. 

? THIS MEANS YOU ARE TRYING TO VIEW BEYOND QUADRANT BOUNDARY WITH THE 
VISUAL~SENSORS (SEE BELOW). 

RRS SUPER-NOVA - AVOID THESE AT ALL COSTS !1! 


EACH QUADRANT IS A 10 BY 10 GRID, WHICH CAN BE EXACTLY TRANSVERSED EITHER IN A 
HORIZONTAL OR VERTICAL (NOT DIAGONAL) DIRECTION WITH A WARP FACTOR OF 1. THE 
CORRECT WARP FACTOR FOR FULL DIAGONAL TRANSVERSE IS 1.4142 (2°0.5) [IN BASIC]. 


EACH OF THE FOLLOWING COMMANDS MUST BE ENTERED AS TWO (OR MORE) SIGNIFICANT 
a LETTERS FOLLOWED BY <CR>. (THE 20 COMMAND-LEVEL OPTIONS) 


**%* COMMAND LEVEL *** 


 aB-ABANDON 


‘\ ABANDON SHIP - SACRIFICE THE ENTERPRISE AND (IF YOU STILL HAVE OPERATIONAL 
SHUTTLE CRAFT) PROCEED AS CAPTAIN OF THE FAERIE QUEENE. 


CH~-CHART 

CUMULATIVE GALACTIC MAP-EACH 'WINDOW' IS OPENED BY USE OF THE LRSENSORS. UNLIKE 
THE USUAL ONES, THIS ONE ALWAYS SHOWS YOU WHERE THE STARBASES AND SUPERNOVAS 
ARE LOCATED. 


CO-COMPUTER 
LIBRARY COMPUTER - SEE COMMAND SUMMARY BELOW 


DA-DAMAGES 
DAMAGE CONTROL/REPAIR. GET A FEEL FOR THIS BY PLAYING. 
WHAT DAMAGE CONTROL/REPAIR REFERENCES: 
SRSENSORS 
LRSENSORS 
PHASERS 
PHOTON TUBES 
LIFE SUPPORT 
WARP ENGINES 
IMPULSE ENGINES 
SHIELDS 
SUBSPACE-RADIO 
SHUTTLE CRAFT 
COMPUTER 
TRANSFER PANEL 
NOTE: THE ABOVE DO NOT ALL NECESSARILY CORRESPOND TO THE TWENTY 
COMMAND-LEVEL OPTIONS. 


DE-DESTRUCT 
SELF-DESTRUCT SERVOS. REMEMBER PASSWORD YOU ENTERED AT BEGINNING. 


DO-DOCK 


WHAT YOU MUST DO WHEN ADJACENT TO A STARBASE, UNLIKE MOST OTHER 'STARTREKS', 
THIS MUST BE SPECIFICALLY COMMANDED; IT IS NOT AUTOMATIC. 


O.-t1e 


IDLE ENGINES - KILL TIME WHILE WAITING FOR REPAIRS TO BE COMPLETED. THIS 
COMMAND IS NULLIFIED WHEN A TRACTOR-BEAM LOCKS ONTO YOUR STARSHIP. 


IM-IMPULSE 

IMPULSE ENGINES - USE THESE WHEN WARP ENGINES ARE OUT (THEY ARE FAR LESS 
ENERGY-EFFICIENT). ALSO CERTAIN STARS HAVE MAGNETIC PROPERTIES, AND IN SUCH 
CASES YOU MUST USE IMPULSE ENGINES TO BREAK FREE, 

LR-LRSCAN 

LONG RANGE SCANNERS - WORKS AS YOU WOULD EXPECT. 


NA-NAVIGATE 
MOVE YOUR STARSHIP THROUGH SPACE. 


PH-PHASERS 
PHASER BANKS. UNDER CERTAIN CIRCUMSTANCES MAY BE DIRECTED AT ENEMY IN ANOTHER 
QUADRANT (SEE PEFFECT BELOW). 


QU-QUIT 
TERMINATE GAME WITHOUT SCORING. 


SH-SHIELDS 


LOWERS RAISED SHIELDS OR RAISES LOWERED SHIELDS. YOU WILL UNDERSTAND WHEN 
AND HOW TO USE THIS AFTER A FEW GAMES, 


SO-SOS 
CALL A STARBASE FOR HELP (THIS INVOLVES A POINT-PENALTY) . 


49 SR-SRSCAN 
g&, SHORT RANGE SCANNERS - THE USUAL, BUT ALSO INVOKES LRSCAN (IF OPERATIONAL) . 


ST-STATUS 


STATUS REPORT OF GAME IN PROGRESS. (MORE COMPREHENSIVE THAN USUAL, 


TO-TORPEDO 

PHOTON TORPEDOS - CAN BE FIRED SINGLY OR IN BURSTS OF THREE. THE LATTER OP- 
TION IS RECOMMENDED WHEN TRYING TO DESTROY A KLINGON COMMANDER (THEY HAVE 
SUPERIOR DEFENSIVE CAPABILITIES). 


QeR- TRANSFER 


TRANSFER PANEL - ALLOWS THE TRANSFER OF ENERGY TO AND FROM PHASER BANKS. 


VI-VISUAL 
VERY SHORT RANGE SCANNER ~ USEFUL FOR LIMITED NAVIGATION WHEN SRSCANNERS ARE 
NON-FUNCTIONAL. A VERY CUTE OPTION. 


WA-WARP 

THIS DICTATES CERTAIN PARAMATERS FOR QUADRANT TO QUADRANT TRAVEL WHEN ENGINES 
(NAVIGATIONAL OR IMPULSE) ARE DAMAGED. YOU WILL BE ADVISED WHEN TO USE THIS 
COMMAND (WASTEFUL TO USE IT OTHERWISE). 


**k* COMPUTER OPTIONS *** 
THESE MAY BE INVOKED WITH A SINGLE LETTER. 


C-COURSE 

GIVES EXACT BEARINGS AND DISTANCES (WARP FACTORS) FROM WHEREVER YOU ARE TO 
ANYWHERE ELSE IN GALAXY. INVALUABLE FOR LONG PHOTON SHOTS. NOTE THAT THE DATA 
MUST BE GIVEN IN THE FOLLOWING FORMAT: IF YOU WISH TO FIND COURSE AND DISTANCE 


TO QUADRANT 3-2, SECTOR 4-10, THE CORRECT INPUT IS '32,0410'. NO OTHER SYSTEM 
OF ENTRY IS ACCEPTED. 


W-WCOST 
THIS COMPUTES HOW MUCH ENERGY WILL BE CONSUMED BY A GIVEN DISTANCE OF TRAVEL 


ov” THE WARP ENGINES, 


I-ICOST 


THIS COMPUTES HOW MUCH ENERGY WILL BE CONSUMED BY A GIVEN DISTANCE OF TRAVEL 
WITH THE IMPULSE ENGINES. 


S-SCORE 
THIS GIVES A PLAYER'S CURRENT SCORE AT ANY TIME DURING GAME. 


P-PEFFECT 


THIS COMPUTES PHASER EFFECTIVENESS AT A GIVEN DISTANCE. WITH EXPERIENCE, IT 
HELPS ONE MAKE A GOOD GUESS ABOUT HOW MUCH ENERGY TO ALLOCATE TO PHASERS. 


O-OUT 


THIS IS COMMAND FOR COMPUTER EXIT. UNTIL THIS COMMAND IS GIVEN, ALL COMMANDS 
ONLY REFERENCE COMPUTER OPTIONS. 


RRKKKEREKRERER ERE EERE KKK KERR RRR ERE RE RERR EKER EERE EERE EERE EER EREEERERERER KEIR 


KHKKKEKKKKKAEREKEKERKEKKEEKEKEKKEEREREKKKKKE ENJOY L181 = ZOSO BXRERKEKKKKKKKKKKKEKE 
RHKRKKR AKER EERE ERK RRR ERR E RRR RR RRR ERE RRR ER RRR IEKRER EEE KER ERE EERE REREREEREK 


D> 


“POLY-vU 
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K&M Company 
TORRANCE, CA 90503 
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-CATALOGO26 
BACCGRRT BAS 
BASEBALLBAS 
BIOCAL BAS 
BIRTHDAYBAS 
BLACKJCKBAS 
BUDGET BAS 
CHAIN BAS 
CHASE BAS 
CHESS BAS 
CIVILWARBAS 
CLIMATESBAS 
CLOUD-9 BAS 
CRAPS BAS 
CRAZY-8 BAS 
EDITM FOR 
GALAXY BAS 
GALAXY2 BAS 
OTHELLO COM 
OTHELLO FOR 
SQUARE BAS 
SWARMS BAS 


More.. 
WEATHER BAS 
WORD-PZLBAS 


‘zoso26 DOC 


25 file(s). 


CPMUG vol. 


37 directory entries remaining. 


A>STAT 0: 


Bytes Remaining On O: 


A> 


33k 


26 


(Altered .ASC to .BAS) 


4/24/85 


type o:-CATALOG.026 


VOLUME 26 


MICROSOFT BASIC AND FORTRAN GAMES AND UTILITIES 


NUMBER’ SIZE 
26.1 4K 
26.2 14K 
26.3 7K 
26.4 6K 
26.5 BK 
26 .6 10K 
26.7 3K 
26.8 12K 
26.9 9K 
26.10 6K 
26.11 6K 
26.12 5K 
26.13 7K 
26.14 1K 
26.15 2K 
26.16 8K 
26.17 16K 
26.18 8K 
26.19 5K 


26 .22 1K 
26 .23 2K 
A> 


NAME 
CATALOG .26 
zosoe6 .DOC 


BACCRRT .ASC 


BASEBALL.ASC 
BIOCAL.ASC 
BIRTHDAY .ASC 
BLACKJACK .ASC 


BUDGET .ASC 
CHASE .ASC 
CHESS .ASC 
CIVILWAR .ASC 
CLIMATES .ASC 
CLOUD-9.ASC 
CRAPS .ASC 
CRAZY-8 .ASC 


GALAXY .ASC 
GALAXY2.ASC 
SQUARE .ASC 
SWARMS .ASC 
WEATHER .ASC 
WORD-PLZ.ASC 
OTHELLO.FOR 


OTHELLO.COM 
CHAIN.ASC 
EDITM.FOR 


COMMENTS 


CONTENTS OF CP/M GROUP VOL 26 

OUR REVIEWER'S COMMENTS ON VOL 26 AND 27 
MICROSOFT BASIC GAME. SEE Z0S026.D0C FOR 
NOTE ON CRT DEPENDENT CODE. 

MICROSOFT BASIC GAME 

BIORHYTHM PROGRAM. SEE ZOS026.D0C. 

GIVES DAY OF WEEK FOR ANY DATE 

MICROSOFT BASIC GAME. SEE z0S026.D0C FOR 
NOTE ON CRT DEPENDENT CODE. 

BUDGET PROGRAM. SEE Z0OSO026.DO0C 

MICROSOFT BASIC GAME 

MICROSOFT BASIC GAME 

MICROSOFT BASIC GAME 

MICROSOFT BASIC GAME 

MICROSOFT BASIC GAME 

MICROSOFT BASIC GAME 

MICROSOFT BASIC GAME. SEE Z0S026.D0C FOR 
NOTE ON CRT DEPENDENT CODE. 

MICROSOFT BASIC GAME 

MICROSOFT BASIC GAME 

MICROSOFT BASIC GAME 

MICROSOFT BASIC GAME 

MICROSOFT BASIC GAME 

MICROSOFT BASIC GAME 

FORTRAN VERSION OF OTHELLO ON VOL 15. 

SEE zOS026.DOC 

EXECUTABLE 26.20 

PROGRAM TO COPY FROM CONSOLE TO XXX.SUB FILE. 
FORTRAN IV PROGRAM. WRITES M80 PRN FILE 
TO LST DEVICE. 


TYPE zoSoO26.D0C (also listed as Z0S027.D0C} All ASL chanyed bv OBS 


** DEPARTMENT STORE ISSUE ** 


ZOSO'S VERY OWN DESK 
Osco NAKED CITY AVE. 
NEW YORK CITY, 100?? 


HELLO KIDDIES, 


I SEE THAT SOME OF YOU HAVE RUN OUT OF IDEAS, AND MOST SADLY YOU WILL COME TO 
REALIZE THAT A COMPUTER IN THE HANDS OF THE 'SLOW' IS NOT MUCH DIFFERENT THAN 
A 'LEICA' IN THE CAMERA BAG OF THE UNTALENTED. 


** RIP-OFF DEPARTMENT ** 


THIS 'COLUMN' WAS AUTHORED AT A TIME OF GREAT PERSONAL STRESS... USUALLY IF 
THE STUFF I RECEIVE FILLS MORE THAN A SINGLE DISK, I WRITE AS MANY REVIEWS AS 
NECESSARY... THIS TIME, YOU'VE ALL BEEN HAD! I'M JUST WRITING ONE LONG COLUMN, 
AND BARRING THE UNFORSEEN, IT WILL APPEAR, AS IS, IN BOTH VOLUME 26 AND VOLUME 
27. NO MATTER WHICH OF THESE TWO VOLUMES YOU ARE RUNNING, YOU WILL NOTICE MORE 
COMMENTARIES THAN ACTUAL PROGRAMS. I DON'T WANT TO GIVE AWAY ALL MY SECRETS, 
BUT I'LL TRUST YOU WITH THIS ONE... IF YOU ARE READING THIS ON ONE OF THE TWO 
VOLUMES (26 OR 27) AND YOU READ A REVIEW OF A PROGRAM, MISSING FROM THE DISK 
IN QUESTION, TRY LOOKING FOR IT ON THE OTHER ONE. I HOPE THIS ADDED MORSEL OF 
DOCUMENTATION WILL HELP YOU ADJUST TO MY LAZINESS WITH MINIMAL TRAUMA. 


** CENSORSHIP DEPARTMENT ** 


THERE ARE A NUMBER OF COUNTRIES (INDIA, UNDER INDIRA GHANDI'S LEADERSHIP WAS 
wm A GOOD EXAMPLE) WHOSE RECENT HISTORY INCLUDES SOMETHING WE DON'T SEE HERE. 

I REFER TO DAILY NEWSPAPERS THAT HAVE LOTS OF BLANK SPACE WHERE ENTIRE COLUMNS 
HAVE BEEN YANKED RIGHT BEFORE PRESS-TIME BY THE GOVERNMENT CENSORS. COULDN'T 
HAPPEN HERE...? DON'T BET ON IT I!!! ALTHOUGH THIS SEGMENT OF MY COLUMN APPEARS 
NEAR THE BEGINNING, IT IS THE VERY LAST THING I WROTE. ORDERS HAVE REACHED ME 
FROM HIGH PLACES TO EITHER DILUTE SOME OF MY PERSONALLY MOTIVATED HARANGUES, 
OR TO COMPLETELY ELIMINATE THEM. I HAVE DECIDED ON A COMPROMISE WHICH REPRE- 
SENTS THE ONLY HOPE FOR MY CONTINUING AT THIS THANKLESS JOB. SAID COMPROMISE 
WILL RESULT IN CERTAIN NAMES AND DESCRIPTIVE TERMINOLOGY BEING REPLACED BY AS- 
TERISKS (ASTERISK FILL?). SINCE THIS WAS TRULY AN ELEVENTH HOUR MANDATE FROM 
THE HIGHER-UPS, THE ASTERISK STRINGS WILL BE OF THE SAME EXACT LENGTH AS THE 
ALPHABETICS WHICH THEY REPLACE. CHRONIC PUZZLE SOLVERS AND INTUITIVE GENIUSES 
SHOULD BE ABLE TO FIGURE IT ALL OUT ANYWAY. ‘ 


P.S, ****, IF YOU PERFORM FURTHER SURGERY ON THIS COLUMN BEFORE ITS RELEASE, 
PLEASE APPEND A FOOTNOTE IN YOUR OWN INOFFENSIVE WORDS, ANNOUNCING MY RESIG- 
NATION. 


** UNDERSTUDY DEPARTMENT ** 


IT IS WITH THE GREATEST OF PRIDE THAT I INTRODUCE YOU TO 'ZOSETTE'. THIS NEAR 
PERFEGT CREATURE IS BEING 'GROOMED' (ISN'T THAT A CATCHY EUPHEMISM FOR WHAT 
SOME CALL 'STATUTORY MASSAGE') TO TAKE OVER MY DUTIES SHOULD EITHER THE POLICE 
OR THE HOSPITAL ATTENDANTS DECODE MY 'RETURN ADDRESS' ABOVE. THIS RAVISHING 
LADY IS NEW AT THE GAME, BUT HER HEART BEATS IN THE RIGHT PLACES, SO I BEG YOU 
TO OFFER HER A FAIR CHANCE. SHE IMPLORED ME TO WITHOLD WHAT I AM ABOUT TO TELL, 
50 SHE COULD BEST GAUGE HER TALENT, BUT I KNOW SHE'S GOT ALL THE TALENT SHE'LL 
EVER NEED, AND THEREFORE I'LL BE HONEST WITH YOU. AS YOU READ ON, YOU WILL NO 
DOUBT NOTICE FOUR ‘REVIEWS' (SEVEN PROGRAMS), WRITTEN IN A STYLE WHICH I HAVE 
NEVER TRIED. — HINT: THE ONES THAT BEGIN WITH THE 'GONG' SOUND EFFECT WERE 

qv? WRITTEN BY ZOSETTE... I DON'T KNOW HOW MY ONCE LOYAL FOLLOWING WILL REACT IF 


a(t? SHE MUST SUDDENLY TAKE OVER. BUT I GUARANTEE THAT IF YOU [GUYS] ARE EVER FOR- 
{ TUNATE ENOUGH TO MEET HER YOU WOULDN'T CARE AT ALL. 


** GOOD & BAD GUY DEPARTMENT ** 


WINNERS: 

=======> TDL (I MEAN XITAN) DISK BASIC VERSIONS 1.06 OR LATER, 'DEBUG' FROM 
THE SAME PLACE, 'SMAL-80' (FROM CHROMOD ASSOCIATES) AND ABOVE ALL THE SUPERB 
'SUPER-DEC' BOARD FROM INTERTEC. IT WILL BE A WHILE BEFORE THIS LAST ITEM IS 
WIDELY AVAILABLE (BUT IF I DIDN'T GET PROTOTYPES, WOULD MY WORD BE 24 CARAT?) 
MAKE NO MISTAKE, THIS IS THE BEST $395.00 I HAVE EVER SPENT FOR ANYTHING AT 
ALL (WELL LET'S SAY THE $500.00 I SPENT ON ZOSETTE'S FAKE PASSPORT — THE ONE 
THAT PROVES THAT SHE'S AT LEAST SIXTEEN — DOESN'T COUNT). THE 'SUPER-DEC! IS 


ALL THAT INTERTEC CLAIMS !!! SADLY, THEIR DELIVERY POLICIES S--K, AND ONE 
COULD EASILY GO BANKRUPT PHONING THEM TO TRACE A PREPAID ORDER, BUT AS I 
SAID... A SUPER PRODUCT I!!! VECTOR GRAPHICS (JUST ON GENERAL PRINCIPLE). I'D 


LIKE TO ADD ANOTHER PLUG FOR XITAN'S 'DEBUG'. IT IS NOT UNLIKE AN ENLARGEMENT 
OF DIGITAL RESEARCH'S 'SID', AND IT HAS THE NEATEST EMBEDDED Z-80 DISASSEMBLER 


THAT I'VE SEEN TO DATE. 


LOSERS: 
======> THE **** FOR THE S-100, XITAN (SSS) FORTRAN, C/BASIC (I EXPLAINED THIS 
BEFORE), PROCESSOR TECH, ‘'**** ##* *eeeeeeREEEET CAND THE SELF-CORONATED, **** 
Bee WHO REE E TT), ANYONE SELLING */***** COMPATIBLE THINGIES (I DON'T 
CARE HOW MUCH YOU GUYS SPEND TO POLISH YOUR IMAGE, STUFF THAT RIVALS WHAT YOU 
DO HAS BEEN OFFERED AS SOURCE CODE IN THE PUBLIC DOMAIN TO THE CP/M USERS! 
GROUP FOR $8.00 PER DISK) -— AND IN CASE I DIDN'T LET THE CAT OUT OF THE BAG, 
THE ARCHVILLAINS TO WHOM I REFER HAVE AN *#**#%% (CA .) *###eHH HEEREEE | SO 
TAKE THAT "ATTRACTIVELY PACKAGED, OFF-THE-SHELF" COLLECTION OF BINARY 'BIT- 
STREAMS! YOU SELL, AND HIDE IT ALL WHERE THE SUN DOESN'T SHINE!!! PERSONALLY 
I'M GETTING SICK OF 'FLOPPY-ROMS' AND THE 'IAPSIS' NONSENSE TOO. I GUESS THAT 
THE TIME IS RIGHT TO LAMENT THE SORRY STATE OF SOME OF THE DOCUMENTATION WHICH 
ACCOMPANIES SOME OTHERWISE EXCELLENT SOFTWARE. I HAVE PREPARED A LIST OF THE 
eres OFFENDERS WHICH FOLLOWS. 


1) THE CP/M MANUALS (FAR AND AWAY THE WORST) - TO WIT, THE 
"INTERFACE GUIDE' (HOW MANY OF US HAVE PL/M COMPILERS ?), 
THE 'ED' SECTION WHICH DOES NOT ATTEMPT TO DOCUMENT THE 
N, P AND Z COMMANDS, AND OF COURSE THAT 'GETSYS' AND 
'PUTSYS' BUSINESS. 

2) THE PART OF THE MICROSOFT FORTRAN WHICH DOESN'T QUITE 
EXPLAIN WHAT YOU ARE SUPPOSED TO DO AT YOUR KEYBOARD. 

3) 'SID' FROM DIGITAL RESEARCH. 

4) XITAN'S 'Z-TEL', 'DEBUG' AND 'LINKER'. 

5) ANYTHING FROM IMSAI OR WHATEVER MITS IS NOW CALLED. 


FOOTNOTES: YOU ARE ALL URGED TO PURCHASE THE 'SMAL-80' MANUAL (IT WOULDN'T 
HURT TO GET 'SMAL-80' AS WELL). THEN YOU WILL GET A TASTE OF JUST WHAT A 
GOOD MANUAL REALLY LOOKS LIKE. THE 'MAC' MANUAL FROM DIGITAL RESEARCH IS 
PRETTY GOOD ALSO. THE XITAN (SSS) FORTRAN MADE MY 'EXCRETA LIST! THIS TIME 
BECAUSE THEY STILL HAVE NOT ISSUED THE 'INLINE-CODE-GENERATOR' MODULE WITH- 
OUT WHICH THIS RUNS 5-10 TIMES SLOWER THAN ITS BETTER KNOWN RIVAL. IF AND 
WHEN THEY DO ISSUE THE 'ICG' MODULE, WE'LL HAVE A REAL CHOICE TO MAKE... 

TDL (XITAN) HAS ALWAYS ISSUED SUPER!I! SOFTWARE, BUT THEY HAVE ALWAYS COME 
THROUGH WITH IT AFTER HAVING HAD A YEAR OR SO TO IMPROVE ON WHAT OTHERS HAVE 
GIVEN US THAT WHOLE YEAR EARLIER. 


** BACKLASH DEPARTMENT ** 


O new, DE-FACTO RULES ARE EMERGING, AND WE OWE A GREAT MEASURE OF THANKS TO THE 
reek eee ERE WHOM IT HAVE BEEN TRYING TO UNMASK, AND TO THEIR NUMBER ONE 
APOLOGIST IN WHOSE HONOR THE 'BLASPHEMY DEPARTMENT ! WAS WRITTEN, A VERITABLE 
'BAY-AREA MAFIA' IF YOU WILL. ANYWAY, THERE IS ONE ITEM THIS TIME THAT IS FAR 
AND AWAY THE BEST PROGRAM OF THIS COLLECTION, AND ALL WE'RE GETTING IS AN 

y 'INT' FILE PLUS THE RUN PACKAGE WITH WHICH IT WORKS. THE GAME IN QUESTION IS 
“i at 'BLUFF' (I WILL REVIEW IT LATER). THE AUTHOR OF THIS DELIGHTFUL DI- 
> -yuxd T CHA  RIFER TN AS MR XX) HAN DERATEN @T'ING US THE Snuiat: n- 


THIS UNIQUE TREASURE (FLATTERY CAN'T HURT), BUT HE DECIDED TO JOIN THE MOUNT- 
ING PROTEST AGAINST OBJECT FILES, BY GIVING US ONE. I HAVE SEEN THE SOURCE OF 
'BLUFF' ON PAPER, AND THIS I CAN TELL YOU... MUCHO EFFORT WENT INTO THIS THREE 
CARD POKER GAME, THE LOGIC WITH WHICH THE COMPUTER PLAYS IS THE RESULT OF HUN- 
DREDS OF REFINEMENTS, THERE ARE ENOUGH WELL CHOSEN REMARKS SO THAT EVEN A CHIM-— 
PANZEE COULD UNDERSTAND HOW EVERYTHING WAS DONE, AND MOST IMPORTANTLY, THIS 
PROGRAM DOES NOT CHEAT. WHEN */***** APPLICATIONS *** *#*#*%** TN SOURCE FOR- 
MAT, AND WHEN THE ***#%* ** THOSE PONDEROUS ****-COVERED ***** REVERSES ***— 
***® ON THE SUBJECT OF *****#ee RRR REEEEER, A FILE 'BLUFF.BAS' WILL BE FORTH- 
COMING (AT LEAST THAT IS WHAT MR. X TOLD ME). 


** BLASPHEMY DEPARTMENT ** 


AN #338 #4002 Re TQ Fe RR Ha, ROK OT HAVE JUST **** **** CONTRIBUTIONS TO 
THE ***. 179 *#eeeRREE SER AND IT SEEMS YOU ARE UP TO YOUR OLD TRICKS AGAIN. 
YOUR REPLY TO *#** ##*#%e%%1 %ee%%% TNDEED HAS ME WONDERING WHOSE SIDE YOU 

ARE REALLY ON. *.*. HAD THE SPINE ** ******* YOUR JUDGMENT (AND TO BE OBJEC- 
TIVE, THE *****% ®* & &** YOU HAPPEN TO LIKE IS NO EXCUSE), THUSLY, YOU LET 

eee CR) RR ANOTHER CASUALTY OF THAT '**** ****! YOU ALWAYS MANAGE TO 

GET IN. IT'S RATHER EASY HAVING THE LAST WORD ** ***** (AND I KNOW THIS AS 

WELL AS YOU). THE BEKNIGHTED INDIFFERENCE YOU SHOW ** *%*%% %ee kee eRee TNPUT 
TO YOUR PURPORTED *****#%%* #%%%* HAS BECOME AN INTOLERABLE MATTER. YOU AND I 
eee REKEE TO GRATIFY OUR EGOS. I'M NOT CONCERNED EXCEPT *** ¥***** WHO BELIEVE 
WHEN SOMEONE SAYS "***%% ¥*" | ITN SHORT, TRY TO BE FLEXIBLE *** ****** ENQUGH 
TO ADMIT DOUBT. I REMAIN SKEPTICAL... BARRING A SWIFT AND DRAMATIC COMEUPPANCE, 
THINGS WILL REMAIN UNCHANGED, AND THAT MEANS, "IF A CONCRETE PYLON CAN BE BENT, 
RRR RRR Rk REE CAN ADMIT TO BEING WRONG ON OCCASION. 


** POTPOURRI DEPARTMENT ** 


THE AUG-78 INTERFACE AGE HAS A TEMPTING ARTICLE ON SOME SUPER LANGUAGE CALLED 
'TEX'... IT IS NOT THE ONE AVAILABLE FROM DIGITAL RESEARCH. THEIR (DR'S) 'TEX! 
IS JUST A TEXT PROCESSOR... AS REGARDS THOSE, THERE IS A SPECIAL TREAT IN STORE 
FOR THOSE OF YOU WHO OWN THE XITAN TEXT-PROCESSOR (TOP.COM)... LET'S PRETEND 

WE HAVE A FILE WITH EMBEDDED 'TOP' COMMANDS CALLED, 'GROUPIE.TOP' (THIS IS A 
LONG REPORT DETAILING WHY THE PRETTY YOUNG 'COMELIES' DON'T LINE UP FOR TENDER 
AND PRIVATE MOMENTS WITH THE MODEST '***##eeeeeee 1 HHH) | RATHER THAN INVOK- 
ING IT AS FOLLOWS: 'TOP GROUPIE <CR>', TRY THIS: 'TOP GROUPIE D <CR>', YOU JUST 
WON'T BELIEVE THEY LEFT THIS OUT OF THE MANUALI!I! MANY OF YOU MAY HAVE SEEN 

THE REPEAT BROADCAST EARLY IN JULY OF A '60 MINUTES' EPISODE IN WHICH THE CBS 
CREW WAS EXPOSING THE SCAM OF SELLING CLASSIFIED ADVERTISING IN ‘BUSINESS DIR- 
TORIES' WHICH ARE ONLY SOLD TO THOSE FOOLS WHO ADVERTISE IN THEM. ANYWAY THE 
MAIL-DROPS FOR THESE BUNKO OPERATIONS CIN THE '60 MINUTES! STORY) WAS LOCATED 


AT 1720 PONTIUS AVE. (IN WEST L.A. OR BEVERLY HILLS - SAME PLACE !!). WHAT THEY 
SHOWED IN SAID EXPOSE WAS AN ANSWERING SERVICE MANNED BY ELDERLY LADIES WHO DID 
NOT SEEM TO KNOW S--— ABOUT S--- ! ONE OF THE NAMES ON THEIR VERY DOOR WAS THAT 


OF AN OUTFIT WHICH ADVERTISES HEAVILY IN THE MAJOR MAGAZINES. I DON'T WANT TO 
GET TOO SPECIFIC... BUT THE VEILED OBJECTS OF MY SUSPICIONS BROUGHT THE '***¥*' 
TO THE S-100 BUS, AND IF YOU TRY TO REACH THEM BY PHONE AT THEIR 'HQ@', LOCA- 
TED AT 1720 PONTIUS AVE. LOS ANGELES 90025, [213] ***-8080, THERE IS A GOOD 
CHANCE THAT YOU WILL ONLY SPEAK TO A LADY WHOSE TENURE AT A SHADY ANSWERING 
SERVICE DEPENDS ON HOW WELL SHE CAN SIDETRACK THE CUSTOMERS, THE BILL COLLEC- 
TORS AND INVESTIGATORS FROM THE ATTORNEY GENERAL'S OFFICE... <*> 


<*> IMPORTANT BULLETIN !!1 THE UNNAMED OUTFIT HAS MOVED II! THEIR NEW NUMBER 
Is [213] ***-8085 (THERE'S PROGRESS FOR YOU), AND THE ADDRESS OF THE NEW ANS- 
WERING SERVICE IS 6464 SUNSET BLVD. LOS ANGELES 90028. LISTEN, I KNOW THAT 
MANY OF YOU LIVE WITHIN STREETWALKING DISTANCE OF THAT PRESTIGIOUS ADDRESS. 
GO THERE, ASK TO SEE THE PRODUCTS; PRODUCE CASH IN LARGE QUANTITY, DEMAND TO 
BUY SOMETHING FROM STOCK, ASK FOR A CATALOG; DO WHATEVER YOU WANT, 1720 PON- 
TIUS AVE. AND 6464 SUNSET BLVD. ARE TWO PLACES WHERE I'D BET YOU WILL NEITHER 
FIND AN ELECTRONICS FACTORY NOR THOSE IN CHARGE OF ONE. I CAN FURTHER TELL 
YOU THAT THE ‘REGIONAL HEADQUARTERS' OF INTERTEC DATA SYSTEMS ARE THE SAME 
THING, WHY DO I GET SO PUT OFF BY THIS...? SIMPLE, IT COSTS MONEY TO CALL 


LONG-DISTANCE, AND PEOPLE WHO REPEATEDLY CALL THE NUMBER OF ANSWERING SER- 
VICES (UNTIL THEY FIGURE OUT JUST HOW SOME GARAGE OPERATTON HAS POLTSIED 


ITS IMAGE) ARE GETTING HOSED. 
** SPECIALTY DEPARTMENT ** 


OTHELLO.FOR 

OTHELLO.COM 

THESE ARE LOVELY REWRITES OF THE OTHELLO GAMES FROM VOLUME 15. THE FORMATTING 
IS MUCH IMPROVED, AND SOME KEY ERROR TRAPS HAVE BEEN ADDED. THERE ARE TWO 
[ERROR TRAPS] WHICH WERE OVERLOOKED HOWEVER. WHEN YOU ARE ASKED, "DO YOU WANT 
TO GIVE ME [COMPUTER] A HANDICAP ?", ANY ANSWER OTHER THAN 'N' OR 'NO! WILL BE 
INTERPRETED AS 'YES'; ALSO ANY IMPROPER REPLY TO THE QUESTION, "HOW MANY COR- 
NERS (1 TO 4) ?" WILL SEND THE PROGRAM INTO AN EXITLESS LOOP FOR WHICH THE ONLY 
REMEDY IS A LEFT-HOOK TO THE RESET BUTTON. 


BLUFF .INT 

RUN .COM 

I EXPLAINED THE RAISON-D'ETRE FOR BLUFF REACHING US THIS WAY. 'RUN.COM' IS THE 
CORRECT RUN-PAK FOR THIS PARTICULAR 'INT' PROGRAM. I HAD SWORN NOT TO WRITE 
ANY MORE PLAYS UNTIL NEXT CHRISTMAS, BUT I WILL TRY TO FILL YOU IN ON WHAT WAS 
SAID WHEN I TELEPHONED THE AUTHOR (MR. X) IN HOPES OF PERSUADING HIM TO GIVE 
US THE 'BAS' FILE. THE DIALOGUE IS VERY LOOSELY PARAPHRASED AS MR. X IS GIVEN 
TO BOUTS OF COARSE AND VULGAR LANGUAGE... A SHORT 'PLAYLET' FOLLOWS........ 


Z: WHY NOT GIVE US THE SOURCE FILE. THE PROGRAM IS EXCELLENT, AND I'M SURE THAT 
EVERYONE WILL WANT TO KNOW HOW IT WAS DONE. 

X: SURE, SO SOMEONE CAN CHANGE A FEW LINES AND SELL IT AS THEIR OWN WORK... 

Z: SOME PEOPLE WILL WANT TO CHANGE THE OUTPUT FOR 64 X 16 CRTS. 

X: THEY CAN GO 'SQUAT' IN THEIR SOMBREROS FOR ALL I CARE. 

Z: SOME PEOPLE WITH GOOD CRTS WILL BE IN TROUBLE AS WELL, BECAUSE EVEN THOUGH 
YOU WERE THOUGHTFUL ENOUGH TO INCLUDE A SCREEN-BLANKING INPUT (A NICE TOUCH 
THAT I'D LIKE TO SEE MORE OF), SOME CRTS CAN ONLY BE BLANKED VIA ESCAPE SE- 
QUENCES, AND YOUR PROGRAM MAKES NO PROVISION FOR THIS. 


@*: LET THE LITTLE (PLURAL NOUN I CAN'T REPEAT) PLAY IT ON A PRINTER !11 


Z: I HAVE SEEN THE SOURCE ON PAPER YOU KNOW, AND I'M PRETTY SURE I COULD RE- 
CONSTRUCT A THOROUGH FLOW CHART FROM MEMORY AND INCLUDE IT IN MY NEXT (THIS) 
COLUMN (I THOUGHT I HAD HIM THERE). 

X: DO AND I'LL JAM A BAYONET UP YOUR (ANOTHER BAD WORD) I1! 

"CLICK"... (THE SOUND OF SOMEONE HANGING UP ON ZOSO) 
Z: (TO MYSELF) WELL I GUESS HE WON THIS ROUND. - END OF PLAY 


** NASTY LITTLE PROGRAMS DEPT. ** 


CHASE .ASC 

WE'VE HAD A FEW VERSIONS OF THIS GAME ARRIVE IN THE MAIL BEFORE. THE REASON 
WE INCLUDED IT AGAIN IS BECAUSE THIS IS THE WORST WE'VE SEEN. SERIOUSLY, ANY 
OF YOU WHO ARE CONSIDERING AN UPGRADE TO A TRS-80 WITH LEVEL-1 BASIC MAY FIND 
THAT YOU CAN EASILY TRANSPORT THIS ITEM TO THAT PARTICULAR COMPUTER. 


CIVILWAR.ASC 

A LOT LIKE THE ONE I WENT OUT OF MY WAY TO INSULT WHEN LAST WE MET. THIS 
GRADUATE THESIS IN COMPUTER SCIENCE ENLARGES ON THE LEGACY OF THE PREVIOUS 
ONE IN SEVERAL KEY AREAS. THIS TIME THE POOR CONFEDERATE GENERAL (YOU) WILL 
NOW SUFFER THE FURTHER MISERIES OF BAD SPELLING, FATAL LOGIC ERRORS AND THE 
CRUELEST CUT OF ALL, THE COMPUTER WILL CALL YOU NAMES. IT'S DOLLARS TO 


DOUGHNUTS THAT THIS THING WAS NEVER PLAYED FOR AS LONG AS IT MUST HAVE TAKEN 
TO WRITE. 


@ wearer .asc 


we 
el? 
4 


CLOUD-9.ASC 
CLIMATE .ASC 
PEEtitltd) GON G@ PLUEPederiyt 
CHUCKIE : UNKNOWN COMIC, WHY DID YOU GONG THE ‘WEATHER TWINS'? I LIKED THEIR 
ACT, BUT THEN AGAIN I LIKE YEAST INFECTIONS. 
~UNKNOWN : WHY DID I GONG THE ‘WEATHER TWINS! - CHUCKIE BABY, CHUCKIE BABY, I 
wy  QPON'T KNOW 'WEATHFR! T' VE SEEN ANYTHING THIS WIERD. OH CHIICKT 


CHUCKIE I'VE SEEN BETTER 'STUFF! IN FAT FARMS. 
CHUCKIE : OH THAT UNKNOWN COMIC IS A MEAN 'RASCULE'. NOW COME ON YOU GUYS, GET 
OFF THE STAGE... 


SNOOPY .ASC 

YET ANOTHER VISITATION OF OUR CUDDLY LITTLE FRIEND. AT LEAST THIS ONE BEARS 
CERTAIN EARMARKS OF AN AUTHENTIC COMPUTER PROGRAM [I.E. SOMETHING BEYOND AN 
ENTIRE PAGE OF CONSECUTIVE 'PRINT' STATEMENTS]. THIS 'SNOOPY' IS WEARING HIS 
ADORABLE AVIATOR'S HELMET — HOW DARLING... THE MYSTERIOUS OBJECT BENEATH HIM 
IS A POISONED STAKE - GUESS WHO PUT IT THERE — HEH, HEH. 


CHESS .ASC 

LAST TIME AROUND SOME PRANKSTER SUBMITTED A PRELIMINARY VERSION OF THIS 
PROGRAM WHICH DID NOT WORK. THANK GOODNESS THIS HAS BEEN RECTIFIED !1! 
THIS VERSION DOES PLAY THE USUAL SUBSET OF CHESS CORRECTLY. THE PIECES 
ARE CODED NUMERICALLY; ALL MOVES ARE ENTERED IN OCTAL [VOMIT]; AND THERE 
IS JUST A FAIR CHANCE THAT GRANDMASTER KARPOV MIGHT BE ABLE TO WIN THE ODD 
GAME FROM THIS CHESTIC POWERHOUSE... IF HE REALLY TRIED HARD MIND YOu !!! 
IN TERMS OF REAL TIME, THIS DOES RUN SLOWLY; AND TO BEAT THIS RATHER POOR 
CHESS PROGRAM JUST ONCE, YOU'D BEST SET ASIDE AN ENTIRE EVENING. MICRO- 
CHESS (TM) FOR THE 8080 IS WIDELY AVAILABLE FOR UNDER $20.00, AND COM- 
PARED TO THIS, IT IS MAGNITUDES BETTER. 


BIOCAL.ASC 

A NICE VARIANT ON THE SHOPWORN OLD BIORHYTHM NUMBER... BUT USE THIS ONE IN 
THE FULLEST OF HASTE ! IT ONLY WORKS FOR 1978 A.D... A REWRITE IN FORTRAN 
WITH PROVISIONS TO DO THE SAME FOR ANY REASONABLE YEAR WOULD BE GLADLY WEL- 
COMED BY ALL. IF YOU COMPUTER-CLUBBIES ARE FEELING THE HEAT, AND FEEL LIKE 
RIOTING, PERHAPS THIS VERY PROJECT WILL KEEP YOU OUT OF TROUBLE. 


SQUARE .LIB 

THIS ONE PLAGUED ME WITH UNEXPLAINED SUBSCRIPT ERRORS WHEN I FIRST TRIED 
IT. I ADDED THREE CONSECUTIVE LINES OF ERROR TRAPPING (SEE IF YOU CAN FIND 
THEM). IT SEEMS TO WORK NOW, BUT I HAVEN'T THE REMOTEST IDEA WHY. IT PLAYS 
AN ODD LITTLE GAME QUITE WELL. I MAY RUIN MY REPUTATION OVER THIS PROGRAM; 
BUT WHAT THE HELL, I LIKE IT. 


NIM.ASC incomplete on Ptorry 

IQUEEN.ASC 

TWO PEAS FROM THE SAME POD... WE'VE ALL SEEN THESE EARLIER IN SOME FORM OR 
ANOTHER. 'NIM', AS YOU'LL RECALL IS THAT WIDELY ACCLAIMED SEDATIVE-HYPNOTIC 
FROM THE DAYS WHEN TEACHERS TWISTED THE EARS OF MISCREANTS WHO WERE DISRUP- 
TIVE IN CLASS, AND BEAT THEIR LITTLE KNUCKLES WITH STEEL-EDGE RULERS. 'IQUEEN' 
IS A NOVEL APPROACH TO THE SAME OLD S---. ALAS, IT SEEMS TO HAVE BEEN FOR- 
MATTED FOR THE HUGE SCOREBOARD IN THE 'SUPERDOME'. THOSE OF YOU WITH VDM'S WILL 
REQUIRE CONSIDERABLE IMAGINATION & RECALL TO PLAY THE LATTER ITEM. 


WRD-PUZ .ASC 


THIS WAS RELEASED EARLIER AS 'W/SEARCH'. THIS ENHANCED VERSION HAS A FEW 
‘NEW-ANCES' THAT MAKE IT WELL WORTH A SECOND LOOK. 


DOTS .ASC 

METHINKS SOMEONE IS ATTEMPTING TO PULL ZOSO'S CHAIN... THE GAME OF ‘DOTS! - 
DO YOU KNOW HOW TO USE IT ? ADMIT YOUR IGNORANCE — REPLY 'NO' AND YOU'LL 

BE TOLD HOW TO PLAY; RATHER YOU WILL BE TOLD HOW TO ENTER YOUR MOVES. THE 
RULES AND OBJECT FOR THIS MICRO-MONSTROSITY ARE NOWHERE TO BE FOUND. TO 

BE FAIR, IT MAY WELL BE THAT THIS GAME (IF THAT'S WHAT IT REALLY IS) IS 
POPULAR IN SOME OTHER REGION OF OUR GREAT LAND. IF INDEED THIS PASTIME 
LIGHTS UP THE LIVES OF THE ALBANIAN ENCLAVE IN TOPEKA OR SOME SUCH THING, 
PLEASE FORWARD THE RULES (IN ENGLISH), AND MAYBE SOME DAY I'LL READ THEM. 


DRAGRACE.ASC 

I THOUGHT I KNEW A GOOD BIT ABOUT THE SUBJECT OF THIS OFFERING, BUT I GUESS 

295", THIS PROGRAM PROVES JUST HOW WRONG I WAS... WHEN I HAD ATTENDED THE 'DRAGS'! 

sole I RECALLED THE SNARL OF HIGH POWER ENGINES, THE SMELL OF BURNING 'SLICKS', 
: = 4 ne rn Wa ey 


ALWAYS MANAGED TO SPILL ON MY TUXEDO... NONE OF THESE THINGS ARE TO BE FOUND 
HERE... YOU ARE INVITED TO 'DESIGN' YOUR DRAGSTER. THIS IS ACCOMPLISHED BY 
SPECIFYING: REAR-END RATIO, HOURSEPOWER [SIC], TIRE WIDTH AND TIRE CIRCUM- 
FERENCE. THEN THE RACE STARTS, AND ABOUT TWENTY MINUTES LATER YOU WILL HAVE 
LOST. I BEG THOSE OF YOU WITHOUT BLINKING FRONT~-PANELS TO TRUST ME WHEN I 
TELL YOU THAT THIS ‘THING! TRULY WORKS (IT REALLY DOESN'T ENTER AN ENDLESS 

r. al — I SWEAR IT I!). I'LL WAGER NOBODY PLAYS THIS ONE TOO OFTEN !!! 
GOLF.ASC 


FOOTBALL .ASC 

BASEBALL .ASC 

THE 'GOLF' AND 'FOOTBALL' GAMES IN THIS GROUP ARE MBASIC REWRITES OF TWO 
FORGETTABLE BASIC/E-C/BASIC GAMES WE'D RECEIVED EARLIER. ALL OF THESE SPOR- 
TING SIMULATIONS REQUIRE YOU TO ENTER NUMERIC CODES WHICH INDICATE YOUR 
'STRATEGY'; PUTTER-IRON, PUNT-PASS, SLIDER-KNUCKLEBALL ETC. AFTER YOU HAVE 
OBLIGED, A RANDOM NUMBER DECIDES WHICH MEANINGLESS RESULT TO DERIVE FROM 
YOUR EQUALLY MEANINGLESS STRATEGIC ENTRY. INTERACTION AT ITS VERY WORST !!! 
BY COMPARISON, I'D SUSPECT THAT TENDING A LIGHTHOUSE WHICH HAD NEITHER WOMEN, 
BOOKS NOR TELEVISION WOULD OFFER MORE EXCITEMENT. [REAL] ATHLETES, SPORTSMEN 
AND THOSE WITH TRIPLE DIGIT I.@.'S ARE URGED TO STAY WELL CLEAR OF THESE !11 
P.S., I UNDERSTAND THAT ICE HOCKEY, BOXING AND TENNIS HAVE BEEN VILIFIED IN 
LIKE MANNER; MY HEARTFELT THANKS GO OUT TO THOSE OF YOU WHO REFRAINED FROM 
SENDING THESE TO US. 


SYNONYMS .ASC 

ANTONYMS .ASC 

WHAT CAN I SAY ABOUT THESE (SAID ZOSO RHETORICALLY) ? THE POINT ESCAPES ME 
ENTIRELY. THE NAMES OF THESE FILES ARE SELF-EXPLANATORY. BRIEFLY ONE IS TO 
PIT THEIR KNOWLEDGE AGAINST THE RATHER LIMITED VOCABULARY OF THE AUTHOR; 
WHAT HAPPENS IS: THE PLAYER (CONTESTANT, PARTICIPANT, ENTRANT, VICTIM) WILL 
GET REPEATEDLY CHASTISED (ADMONISHED, BROWBEATEN, SCOLDED, TAUNTED) FOR SUG- 
GESTING PERFECTLY CORRECT ANSWERS WHICH NEVER MADE IT INTO THE POORLY CON- 
CEIVED DATA BASE UPON WHICH THESE 'GEMS' (PASTEBOARD, GLASS, RHINESTONES) 
DEPEND. THERE MAY STILL BE SOME SALVAGE VALUE; MERGE THESE TWO INTO A SIN- 
GLE UNIT AND CALL IT 'ERASONYM.ASC'; THEN FREE UP SOME DISK SPACE. 


BUDGET .ASC 

THIS MAY BE A WINNER, GANG... I DON'T WANT MY COMPUTER TO USURP THE DELIGHT 

I DERIVE FROM MERELY APPLYING COMMON SENSE TO MY OWN LIFE. THIS PROGRAM DOES 
HOWEVER FILL A SIGNIFICANT VOID FOR THOSE WHO FEEL DIFFERENTLY. I'LL ADMIT 

I DIDN'T FOLLOW THIS ONE ALL THE WAY THROUGH, BUT MY FIRST IMPRESSION SUG- 
GESTS THAT THIS REALLY MIGHT BE VERY GOOD FOR 'BUDGETING' ONES' EXISTENCE. I 
WAS ALL SET TO FAULT IT FOR MAKING NO ALLOWANCES FOR VICE & NARCOTICS (WITHOUT 
WHICH TIMES CAN GET BORING). I WAS FOOLED THOUGH, THERE ARE ENTRIES FOR ENTER- 
TAINMENT AND PHARMACEUTICALS (THE SAME IN MY BOOK). THIS IS A GOOD ONE !1 


BIRTHDAY .ASC 

Plttttit GON G UCLIEbtbtriel 

CHUCKIE : 'JUICE', WHY DID YOU GONG 'MR, BIRTHDAY'? I LIKED THAT ACT; BUT 
THEN I LIKE TO WATCH LEPERS SHED. <+> 

JAYE P. : I'D BE GLAD TO LET 'MR. BIRTHDAY' SIT ON MY - O OP S !1I —- BUT 
THEN AGAIN I'D LIKE TO - 0 O P § 1! HIS CARK !1 

CHUCKIE : OH THAT EVIL JAYE P. 'MORGONE'... I GUESS SHE JUST WANTS TO 
0 OPS !! YOUR CARK !1... GET OFF MY STAGE !! 


<+> -— I THINK SHE'S GOT IT !1! Z. 


CHAIN .BAS 

YOU C/BASIC PEOPLE HAVE NOW INHERITED A CLEVER LITTLE ROUTINE FOR 'CHAINING' 
(MERGING) PROGRAMS. I HAVE NEVER LIKED YOUR AWFUL LITTLE 'INT' FILES, BUT YOU 
WILL BE ABLE TO CREATE BETTER ONES WITH THIS. 


BACCARAT .ASC - 
yse BLACKJCK ASC 
pol? ~=CRAZY-8.ASC 
& “rr 2 °'4491 GQHARE THTS TN COMMON: T LIKED WHAT I SAW EXCEPT FOR THE HIDEOUS 


ui? 


FORMATTING AND THE ERROR TRAPS, WHICH WERE EITHER MISSING OR POORLY WRITTEN. 
I UNDERTOOK FIXES ON ALL THREE, AND GIVEN THAT I SPENT ABOUT 10 MINUTES ON 
EACH, MAYBE I DID A REASONABLY GOOD JOB. AMONGST THE THINGS I ADDED WAS THE 
COMMAND: 'PRINT CHR$(26)'; THIS BLANKS THE SCREEN ON MY ADM-8. THOSE WITH 
OTHER CRT'S WILL HAVE TO CHANGE THIS ONE THING. ALSO, THESE GAMES NEED TO 

BE 'RANDOMIZED' IN SOME FASHION, BUT THAT'S A PAIN IN THE 'KEYSTER', SO I'LL 
LEAVE THAT TO YOu. 


ROULETTE .ASC 

CRAPS .ASC 

TEttiti! GON G UIP trbery 

CHUCKIE : REX REED YOU 'RASCULE', WHY DID YOU GONG THE 'CASINO BROTHERS'? 

; I THOUGHT THEY WERE GOOD; BUT THEN AGAIN I'M TURNED ON BY SEEING 

THE FISH FLOAT AFTER A BIG CHEMICAL SPILL, 

REX REED: I ONLY BET ON COCKFIGHTS! 

CHUCKIE : WELL THAT'S IT. MEAN OLD REX WOULD RATHER BET ON A COCKFIGHT... 
GET OFF THE STAGE !!! 


MASTERMD .ASC 

THIS IS A NICE COMPACT LITTLE PROGRAM WHICH PLAYS THE GAME OF 'MASTERMIND', 
THE GAME WILL REMIND YOU OF 'BAGELS'. CLEVERLY WRITTEN !!! TO GET TO THE 
POINT, I LIKED IT, AND SO WILL YOU !! THERE IS A MINOR 'BUG' WHICH CROPS UP 
EVERY NOW AND AGAIN, BUT IT IS OF NO MOMENT. 


HANGMN-1 .ASC 

HANGMN-2 .ASC 

HANGMN-3 .ASC 

I REALIZE THAT I AM BREAKING NEW GROUND IN WRITING TWO CONSECUTIVE FLAT- 
TERING PARAGRAPHS; BUT TRUTH IS A HARD THING, EVEN FOR ME, SO HERE GOES... 

I LIKE ALL THREE OF THESE. I HAD BEEN SICK OF 'HANGMAN' GAMES EVER SINCE 
COMPUTERS BECAME THE RAGE, BUT THESE ARE EXCELLENT I!!! I HONESTLY ENJOYED 
PLAYING THIS GAME AT ALL THREE LEVELS. OF PARTICULAR NOTE IS THE VERY ADROIT 
WAY IN WHICH THE DATA TABLES ARE ENCRYPTED IN 'HANGMN-3'. BRAVO !!1 


MAZE .ASC 

SWARMS .ASC 

STARTREK.ASC 

I GET THE FEELING OF DEJA-VU ABOUT THESE. THEY MUST BE DIFFERENT FROM THE 

ONES WE'VE RELEASED EARLIER. OTHERWISE WHY WOULD SOMEONE HAVE BOTHERED TO 

SEND THEM IN. I REFER YOU TO REMARKS OF MINE (PUBLISHED EARLIER) REGARDING 
'MAZE' AND 'SWARMS' PROGRAMS. I SAID IT ALL THEN AND EVER SO CLEVERLY. AS 

REGARDS THIS 'STARTREK! — YAWN I!!! 


SHOP.ASC 

I GET THIS NAGGING FEELING THAT THIS ONE REACHES US COURTESY OF THOSE ZANY 
CUT—-UPS FROM THE COMPUTER STORE IN LOS ANGELES. YOU MAY REMEMBER THEM FOR 
THEIR MEMORABLE PROGRAM 'TACOS', WHICH RECEIVED A MOST LUKEWARM COMMENTARY 
FROM ME LAST TIME. THIS WRETCHED LITTLE THING DOES NOTHING BUT INSULT YOU 

AT ITS OWN SLUGGISH PACE. IF THIS DID COME FROM YOU CLOWNS IN L.A., YOU GUYS 
OUGHT TO TAKE A VACATION. THE VILE AIR YOU BREATHE IS MAKING YOU MEAN, IF 
THIS CAME FROM ANYONE ELSE, MAY GOD HAVE MERCY ON US ALL. THINK OF WHAT THE 
WORLD MIGHT BE LIKE IF EVERYONE STARTED CREATING DELIBERATELY AWFUL GAMES 

TO PLAY ON THE COMPUTER. IN EITHER CASE, I PROMISE YOU THAT THIS THING WAS 
CONCEIVED IN THE NAME OF INTENTIONAL CRUELTY. WITHOUT ANY RESERVATION, I'LL 
ADMIT MY INABILITY TO THINK OF AN ITEM I'VE LIKED LESS... A TRUE COW-FLOP 11! 


GREEKRTS.ASC 

PPHttit! GON G TILTbtetrbtye 

CHUCKIE : JAMIE FARR, LONG OF NOSE AND CUTE OF SKIRT, WHY DID YOU GONG OUR 
PAL 'SODOMOCLES THE GREEK'? I LIKED THAT ACT, BUT THEN AGAIN I LIKE 
TO WATCH BIG SHARKS NAIL THE ODD SWIMMER. 

JAMIE F.: HE NEEDED MORE VASELINE. 

CHUCKIE : AW, ‘SOD THE GREEK', TOO BAD... GET OFF 1!!! 


MEMBRAIN.ASC 
m2 '§ ye TKE A GAME NNESN'T TT? (...RRATN)I? —- DON'T RE MTSLED!I WHAT WEIR. 


- o 
aA 


v 


DEALING WITH HERE IS JUST ANOTHER SPELLING LAPSE. THE NAME SHOULD PROBABLY 
HAVE BEEN 'MEMBRANE!'... HERE'S THE SCENARIO: YOU ARE A SEMI-PERMEABLE MEM— 
BRANE WHOSE JUDGMENT REGARDING NUTRIENT AND ELECTROLYTE DILUTIONS WILL DE- 
TERMINE THE GROWTH RATE OF THE CELLS WITHIN YOUR PHYSICAL DOMAIN. THIS WAS 

NO DOUBT A HIGH SCHOOL BROWN-NOSE PROJECT GONE AWRY. YOU SEE, (WHOEVER IN 
HELL WROTE THIS), THERE'S A LOT THEY DIDN'T TEACH YOU IN TRADE SCHOOL (OR 

WAS IT ONE OF THOSE SEXUALLY STIFLING MILITARY ACADEMIES): IF YOU GET TOO 
GOOD AT THIS [GAME?], THE CELLS WILL DIVIDE REALLY WELL... AND YOU KNOW WHAT 
THAT MEANS, DON'T YOU? YOU'LL HAVE TO GO INTO THE HOSPITAL FOR SURGERY, IR- 
RADIATION OR PERHAPS ENOUGH METHOTREXATE TO MAKE YOUR HAIR FALL OUT WHILE 

YOU PUKE FROM THE SOLES OF YOUR FEET UP. NEXT FALL, WHEN YOU HAVE TO GO TO THE 
SCHOOL INFIRMARY BECAUSE OF THAT SORE YOU'VE HAD EVER SINCE FAT ***** LET YOU 
GO ALL THE WAY, JUST ASK 'DOC' (THAT IS HIS NAME, RIGHT?) WHAT YOUR OLD PAL 
ZOSO WAS TRYING TO TELL YOU. 


DISSAMBR.ASC 

WHAT A GREAT FILENAME!!! WHEN I SAW IT MY HEAD DANCED WITH DREAMS OF PLACES 
FAR AWAY, EXOTIC WOMEN WEARING PERFUME I HAD NEVER SMELLED AND HIGH ROMANCE 

IN THE DARKEST CORNERS OF MOROCCAN CASBAHS... I GUESS I ASSUMED FROM THE NAME 
THAT IT MEANT SOMETHING LIKE "DISABUSE YOURSELF OF 'AMBER' (THE SULTRIEST 

LADY I'D EVER SEEN ~— NOBODY EVER KNEW HER REAL NAME, BUT SHE WORE AMBER JEW-— 
ELRY EVERYWHERE (YES EVEN THERE), AND I GUESS THE NAME JUST STUCK)". IN TRUTH 
THIS IS JUST AN 8080 DISASSEMBLER, AND ALTHOUGH I'VE NEVER MET THE AUTHOR, 
I'LL BET I CAN SUPPLY A REASONABLY ACCURATE IDEA OF HOW AN 8080 [BASIC] DIS- 
ASSEMBLER CAME TO PASS. LET US NOT FORGET THAT 'MBASIC' AS WE CP/M'ERS KNOW 
IT, ONLY CAME ABOUT WHEN MITS (THERE WERE NO FLOWERS AT THE WAKE) LOST A BIG 
LAWSUIT TO MICROSOFT. BEFORE THAT, 'ALTAIR' [RETCH, GAG & BARF] BASIC WAS THE 
ONLY WAY ITS USERS COULD INTERACT WITH THEIR MAGNETIC DISKS. THERE WAS NO OPER- 
ATING SYSTEM (AS WE TAKE FOR GRANTED), JUST MITS' [DRY HEAVE] BASIC. SOME POOR 
MISBEGOTTEN SOUL WHO'D NEVER HEARD OF CP/M ('DDT' IN PARTICULAR) TRIED TO HELP 
MITS SURVIVE THE SOFTWARE VACUUM (WHICH BELATEDLY HELPED THEIR FINAL DEMISE). 
I'LL BET YOU (THE AUTHOR) STUCK WITH MITS BECAUSE YOU'D ALREADY INVESTED YOUR 
LIFE AS CHIEF HONCHO OF THE 'BOWMAR BRAIN! USER'S GROUP. TOUGH NOOGIES, PAL, 
LIVE AND LEARN... 


GALAXY .ASC 

GALAXY2 .ASC 

WHAT WE'VE GOT HERE IS AN ORIGINAL AND AN 'ENHANCEMENT!'. BOTH REACHED US 
COURTESY OF THE PERSON WHO 'UPGRADED' THE ORIGINAL. FIRST THE ORIGINAL: A 
NICE COMPACT LITTLE PROGRAM WHICH WITH A FEW ADDED CONTROL CHARACTERS COULD 
REALLY BE DYNAMITE ON A COLOR SCREEN. NEXT THE 'UPGRADE': I FEAR THE TRAGIC 
CONSEQUENCES OF 'ANGEL-DUST' (PHENCYCLIDINE) POISONING ARE EVIDENT HERE. A 
ONCE ,GOOD MIND CORRODED BY THAT FILTHY DRUG... IF YOU (UPGRADER) CAN REMOVE 
YOUR HEAD FROM THAT BAG OF GLUE YOU ARE SNIFFING TO HEAR A LITTLE CONSTRUC- 
TIVE CRITICISM, IT WOULD BE THIS, "LEAVE WELL ENOUGH ALONE", 


** OLD CONTEST DEPARTMENT ** 


IF YOU RECALL, THE LAST CONTEST OFFERED A MODEST PRIZE TO THE PERSON WHO 
COULD SUPPLY THE BEST ALGORITHM FOR 'RANDOMIZING' MICROSOFT DISK BASIC. WELL 
WE HAVE A WINNER, BUT I CAN'T TELL YOU MUCH MORE THAN JUST THAT. THE WINNER 
(WHOSE PAYCHECKS ARE SIGNED BY MR. XITAN) DOES NOT WANT THE PUBLICITY FOR 
OBVIOUS REASONS. THE WINNING SOLUTION WHICH HE PROVIDED IS ALSO UNAVAILABLE 
FOR PUBLICATION BECAUSE IT MATCHES BYTE FOR BYTE THE (SHORT!) ROUTINE WHICH 
THE LATEST VERSION OF XITAN BASIC USES FOR EXACTLY THE SAME PURPOSE. I KNOW 
THE SOUND OF A COP-OUT WHEN I HEAR ONE, SO I'LL GIVE YOU AS MUCH INFORMATION 
AS I DARE. THE MYSTERY ROUTINE IS INVOKED VIA THE 'USR' CALL TO THE AREA OF 
MEMORY (LESS THAN 0.05 K) WHICH CAN RESIDE JUST ABOVE BASIC OR JUST ABOVE 
CP/M. IN FACT, THE WINNING ENTRY IS SO COMPACT, THAT IT CAN FIT IN MEMORY 
BELOW 0100H, AND NOT CONFLICT WITH THE REST OF CP/M tI! . NATURALLY, IT ONLY 
WORKS WITH THE Z-80. HOPING I DON'T LOSE A VALUABLE ALLY, I'LL TELL YOU THIS 
MUCH MORE: THE Z-80 HAS A REFRESH ('R') REGISTER WHICH CAN BE READ, BUT NOT 
WRITTEN INTO. EVERY SINGLE TIME SOME CHEAPO DYNAMIC MEMORY REQUIRES A BLAST 
OF REFRESHMENT, THE VALUE OF THE 'R' REGISTER IS CHANGING... IMAGINE THE 
POSSIBILITIES. 


** NEW CONTEST DEPARTMENT ** 


THIS TIME THE ISSUE IS THE 
DISK BASIC. HERE ARE THE RULES: 
IT CAN, 


THER SUBTERFUGE)? TONY AND I HAVE CROSSED SWORDS ON THIS ISSUE, 
(NO MATTER WHAT THEY 


SOME TASTY PRIZES TO THE WINNER 
PRIZES: 


LOS ANGELES AREA 
NEW YORK AREA 

SAN FRANCISCO AREA 
GREATER COLORADO 


MIDWEST 

SOUTHEAST 

NORTH CENTRAL AREA 
NORTHWEST AREA 
SOUTH CENTRAL AREA 


CANADA 
MEXICO 
OVERSEAS 


EVERY LADY ON THE ABOVE LIST IS REAL, 


WHAT I MEAN). 


THEN THE PRIZE WILL BE REALLY SPECIAL (I HOPE I DON'T SOUND IMMODEST). 
THE JOINT IS BURNING SHORT IN MY OVERWORKED FINGERS, 
AND ZOSETTE IS TRYING TO FIX MY ZIPPER (WHICH WAS NEVER EVEN BROKEN); 


GUESS IT'S TIME TO MOVE ALONG... 


"PRIVACY! COMMAND IN THE NEWEST TDL, 
CAN THIS COMMAND BE BYPASSED (WELL OBVIOUSLY 


IF ONLY USED AS XITAN SUGGESTS) OR CAN'T IT (CIF ONE CAN ADD SOME FUR- 


OOPS XITAN 


AND I OFFER 


"PROVE'). HERE ARE THE 


DENISE, MICHELLE, LAUREN ETC. 
NICOLE, SUSAN, SUZIE & EVEN MORE 
ADRIENNE, LEE, SHEILA & DANIELLE 
LOUISE, DEBBIE, KARIN, TRICIA 

LIZ, ELIZABETH... THE LIST COULD 

GO ON FURTHER, BUT NOBODY OUT THERE 
NEEDS MY HELP 

BARBIE, JEANETTE, LORRAINE 

PENNY, SUSAN (ANOTHER) & JILL 

PAM, CAROL & JILL (ANOTHER) 

CAROLE & JEAN THE INDIAN 

DARLA & PATTI (I USED TO ** *#####% 
** THIS ONE) 

TOO NUMEROUS TO LIST 

NEVER MIND 

NO PROMISES 


BEAUTIFUL AND FRIENDLY (IF YOU KNOW 


HERE'S THE GOOD PART — I HOPE A PRETTY LADY IS THE WINNER, FOR 
WELL, 
MY EYES ARE GETTING RED 
so I 
I HOPE YOU ALL HAD A GOOD SUMMER... TO THE 


@ vrs WHO READ THIS, GET IT WHILE YOU'RE YOUNG — TO THE LADIES, STAY MOIST !!! 


TYPE O:MEGATREK.DOC 
Dear Zoso: 


Enclosed please find one (1) MEGATREK.ASC. 
that will 
Basic Version 4.5 in a 63k CP/M system. 


of Volume 22.1, BIGTREK.ASC, 


JRP 
15 Aug 78 


C> 


I LOVE YOU ALL (REALLY I DO) 


Zoso 


ME TOO, ZOSETTE 


This is a version 
load and execute with MICROSOFT 
Have Fun. . 


FT BLIMIT.CAS 
FOOTBALL 


INSTRUCTIONS FOR PLAYING FOOTBALL 


ON OFFENSE YOU HAVE THE FOLLOWING PERMITTED PLAYS: 


PLAY CODE 
RUN 10 
PASS 11 
SWEEP 12 
SCREEN PASS 13 
LONG PASS 14 
DRAW PLAY 15 
PUNT 16 
FIELDGOAL 17 


ON DEFENSE, YOU MAY TRY GONE OF THE FOLLOWING: 


DEFENSE ODE 
NORMAL GOOD AGAINST SWEEP AND SCREEN 
HOLD GOOD AGAINST RUN, PASS AND DRAW 


INTERCEPT INCREASES THE ODDS FOR AN INTERCEPTION 
BLOCK GIVES YOU A CHANCE TO BLOCK A KICK, 
BUT DECREASES THE DISTANCE RUNBACK. 


Cc 
4 
5 
BLITZ 6 GOOD AGAINST PASS OR LONG PASS 
7 
8 


TO CALL A PARTICULAR PLAY JUST TYPE ITS CODE NUMBER. 
ALSO, AT ANY TIME DURING PLAY YOU MAY CALL TIME OUT 

BY TYPING A '2'. HOWEVER YOU ARE PERMITTED ONLY THREE 
TIMEOUTS PER HALF. 


CPMUG vol. 27 (Altered .ASC to .BAS) 4/24/85 updated 11/20/85 _ 


-CATALOGO27 2K 
ANTONYMSBAS 6K 
BLUFF INT 11K 
DISSAMBRBAS 4k 
DOTS BAS 8K 
DRAGRACEBAS 3K 
FOOTBALLBAS BK 
FTBLINSTBAS 8K 
GOLF BAS 10K 
GREEKRTSBAS 2K 
HANGMN-1BAS 6K 
HANGMN-2BAS 6K 
HANGMN-3BAS 6K 
HIDESEEKBAS 3K 
IQUEEN BAS 5K 
MASTERMDBAS 2K 
MAZE BAS 5K 
MEGATREKBAS 46K 
MEGATREKDOC 1K 
MEMBRAINBAS 7K 
NIM BAS 2K 
ROULETTEBAS 7K 
More.. 

RUN “. COM 12K 
SHOP BAS SK 
SNOOPY BAS 4K 
STARTREKBAS 7K 
SYNONYMSBAS 8K 
Zoso27 boc 32K 


28 file(s). : 
33 directory entries remaining. 
COSTAT O: 


Bytes Remaining On O: 16k 


‘FTBLINST.BAS added 11/20/85 is a file generated by MCA to print out 


the instructions for the footbal| game with a hardcopy option. 


CA 99503 


K&M Company 


{ TORRAaNC 


fi 
¥ 


oO 


TYPE 0:-CATALOG.027 


VOLUME 27 


MICROSOFT BASIC GAMES 


NUMBER SIZE 
27.1 6K 
27 .2 4k 
27.3 8K 
27.4 3K 
27.5 8K 
27.6 10K 
27.7 2k 
27.8 6K 
27.9 6K 
27.10 6K 
27.11 3K 
27.12 5K 
27.13 2K 
27.14 5K 
27.15 7K 
27.16 2K 
27.17 7K 
27.18 SK 
27.19 4k 
27.20 7K 
27.21 8K 
27 .22 11K 
27.23 12K 
27.24 46K 


NAME 
CATALOG .27 
Z0S027 .DOC 


ANTONYMS .ASC 
DISSAMBR.ASC 
DOTS.ASC 
DRAGRACE.ASC 
FOOTBALL .ASC 
GOLF.ASC 


‘GREEKRTS .ASC 


HANGMN-1 .ASC 
HANGMN-2 .ASC 
HANGMN-3 .ASC 
HIDESEEK.ASC 
IQUEEN .ASC 
MASTERMD .ASC 
MAZE.ASC 
MEMBRAIN.ASC 
NIM.ASC 
ROULETTE .ASC 
SHOP .ASC 
SNOOPY.ASC 
STARTREK.ASC 
SYNONYMS .ASC 
BLUFF .INT 
RUN .COM 


MEGATREK.ASC 


MEGATREK.DOC 


COMMENTS 


CONTENTS O 
OUR REVIEW 
MICROSOFT 


DISASSEMBLER. 


MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
MICROSOFT 
GENERATES 
MICROSOFT 
MICROSOFT 
MICROSOFT 
RUN PROGRA 
Z0S027 .DOC 
22.1 TRIMM 
VERSION 4. 
NOTE ON ME 


F CP/M GROUP VOL 27 
ER'S COMMENTS ON VOL 26 AND 27 


BASIC GAME 


BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 
BASIC GAME 


SNOOPY PICTURE 


BASIC GAME 
BASIC GAME 
BASIC GAME 


M TO EXECUTE BLUFF.INT. 


ED TO RUN UNDER MICROSOFT BASIC 
5 IN A 63K CP/M SYSTEM 


GATREK 


SEE zoS027 .DOC 


POLY-vU 
#PV119 


TORRANCE, CA 99503 


K&M Company 


S| 


CPMUG vol. 29 10/19/85 


~-~CATALOG029 3K 
ALLOC ASM 2K 
CHASE ASM 9K 
DEFLECT ASM 8K 
DOWHILESLIB 1K 
EDIT ASM 24K 
FPCONV SRC 14K 
FPDATA SRC 2K 
FPINT SRC 8K 
FPPKG SRC 29K 
IGADD MAC 1K 
MON1 MAC 1K 
MON2 MAC 1K 
MOVE ASM 5K 
MOVENMACASM 6K 
MUSIC ASM 8K 
MUSICP COM 2K 
NCOMPARELIB 2K 
NOTATE ASM 3K 
PIRANHA ASM 12K 
ROBIN ASM 19K 
ROBOT ASM 3K 
More.. 

SAP ASM 5K 
SELECTS LIB 2K 
SEQIO LIB 11K 
SYMSTACKLIB 1K 
TARGET ASM 3K 
TIMESQ ASM 5K 
TRAN SRC 13K 
TTT ASM 25K 
UNLOAD ASM 2K 
VDM DOC 1K 
VOLUME29DOC 3K 
WHENS LIB 1K 
WSYSGEN ASM 3K 


35 file(s). 

25 directory entries remaining. 
C>STAT O: 

Bytes Remaining On O: 3k 


C> 


TYPE 
VOLUME 29 


-CATALOG. 029 


ASSEMBLER GAMES AND UTILITIES AND CP/M BASIC-E VERSION 1.4 FLOATING 
POINT SOURCE(OBTAIN VOLUME 30 ALSO FOR COMPLETE SET) 


NUMBER SIZE NAME COMMENTS 
CATALOG. 29 CONTENTS OF CP/M GROUP VOLUME 29 
VOLUME29 .DOC COMMENTS ON PROGRAMS ON VOLUME 29 

29.1 25K TTT.ASM 3-D TIC TAC TOE GAME 

29.2 9K CHASE.ASM VDM/SOL GAME. 15.3 WITH CP/M I/O. SEE 
VOLUME29.DOC. 

29.3 3K TARGET. ASM VDM/SOL GAME. 

29.4 8K DEFLECT.ASM VDM GAME 

29.5 8K MUSIC.ASM MUSIC PROGRAM 

29.6 2K MUSICP.COM MUSIC PROGRAM WITH TABLE FOR "SOUNDS OF 
SILENCE" 

29.7 12K PIRANHA.ASM VDM GAME 

29.8 19K ROBIN.ASM USES POLY VTI. SEE VOLUME29.DOC. 

29.9 3K ROBOT.ASM VDM GAME 

29.10 2K ALLOC.ASM DISK ALLOCATION DISPLAY. SEE VOLUME29.DOC. 

29.11 24K EDIT.ASM DISASSEMBLY OF 16.5. SEE VOLUME29.DOC. 

29.12 5K SAP .ASM SORTS AND PACKS DIRECTORY. IMPROVED VERSION 
OF 19.8. SEE VOLUME29.DOC. 

29.13 3K NOTATE.ASM ADDS COMMENTS TO ASM SOURCE. ASSEMBLE USING MZ 
SEE VOLUME29.DOC. 

29.14 1K SYMSTACK.LIB ASSEMBLER TIME PUSH/POP LIB FOR MAC. SEE 
VOLUME29.DOC. 

29.15 2K NCOMPARE.LIB CORRECTED VERSIONS OF DIGITAL RESEARCH 
DISTRIBUTION. SEE VOLUME29.DOC. 

29.16 11K SEQIO.LIB CORRECTED VERSION OF DIGITAL RESEARCH 
DISTRIBUTION. SEE VOLUME29.DOC. *] 

29.17 1K WHENS.LIB MODIFICATION OF DIGITAL RESEARCH VERSIONS TO 
ALLOW INFINITE NESTING. SEE VOLUME29.DOC. 

29.18 1K DOWHILES.LIB MODIFICATION OF DIGITAL RESEARCH VERSIONS TO 
ALLOW INFINITE NESTING. SEE VOLUME29.DOC. 

29.19 2K SELECTS.LIB MODIFICATION OF DIGITAL RESEARCH VERSIONS TO 
ALLOW INFINITE NESTING. SEE VOLUME29.DOC. 

29.20 1K IGADD .MAC SUBROUTINE CALLABLE FROM FORTRAN-80 

29.21 1K MON] .MAC SUBROUTINE CALLABLE FROM FORTRAN-80 

29.22 1K MON2 .MAC SUBROUTINE CALLABLE FROM FORTRAN-80 

29.23 2K UNLOAD .ASM CONVERTS COM FILE TO HEX. ASSEMBLE USING MAC. 
SEE VOLUME29.DOC. 

29.24 14K FPCONV. SRC CP/M BASIC-E FLOATING POINT CONVERSION PACKAGE 

29.25 2K FPDATA.SRC EQUATE TABLES FOR FPCONV 

29.26 8K FPINT.SRC INTERFACE BETWEEN INTERPRETER AND FLOATING 
POINT PACKAGE 

{29.27 29K FPPKG.SRC INTERPRETER 

29.28 13K TRAN.SRC TRANSCENDENTAL FUNCTION PACKAGE 

29.29 5K MOVE.ASM 1 DISK MOVE PROGRAM. ASSEMBLE USING MAC. 

29.30 6K MOVENMAC .ASM MOVE.ASM WITH MACROS EXPANDED FOR ASSEMBLY 
USING ASM. 

29.31 5K TIMESQ.ASM SIGN GENERATOR FOR VDM. 

29.32 3K WSYSGEN.ASM PROGRAM TO SYSGEN A STACK OF DISKS EASILY. 

29.33 1K VDM.DOC MODIFY ED TO PAGE 16 LINES INSTEAD OF 24. 

O> 


TYPE VOLUME29.DOC 
THESE PROGRAMS ARE FROM BRUCE RATOFF. 


TARGET, CHASE - THESE ARE THE VDM/SOL GAMES WHICH HAVE APPEARED 
PREVIOUSLY, BUT NOW INCLUDE CP/M I/O. 


SAP - UPDATE OF PROGRAM ON VOLUME 19, WITH MODS TO RUN IN ANY 
MEMORY SIZE OR BIOS ADDRESS. ALSO, NO LONGER DELETES NULL 
EXTENTS OF NON-NULL FILES (BUG IN PREVIOUS VERSION). 


ALLOC - PREVIOUSLY RELEASED PROGRAM, WITH CORRECTIONS. SHOULD 
NOW RUN WITH BOTH VERSION 1.3 AND VERSION 1.4 SYSTEMS. 


NCOMPARE.LIB, SEQIO.LIB ~ CORRECTED VERSIONS OF MACRO LIBRARIES 
DISTRIBUTED WITH DIGITAL RESEARCH MAC ASSEMBLER, 


SYMSTACK.LIB - ALLOWS ASSEMBLY-TIME PUSHES AND POPS OF SYMBOL 
VALUES. FOR MAC ASSEMBLER. 


WHENS.LIB, DOWHILES.LIB, SELECTS.LIB ~- MODIFICATIONS OF MACRO 
LIBRARIES SUPPLIED WITH MAC TO ALLOW INFINITE NESTING. NEEDS 
SYMSTACK.LIB. 


NOTATE - PROGRAM TO ADD COMMENTS TO AN ASSEMBLER SOURCE. 
DISPLAYS EACH UNCOMMENTED LINE AND ACCEPTS A COMMENT. 
CARRIAGE RETURN SKIPS TO NEXT LINE WITHOUT INSERTING COMMENT. 
CONTROL-Z, CARRIAGE RETURN TERMINATES PROGRAM (RECOPIES REST 
OF FILE UNMODIFIED). INVOKED BY "NOTATE PROGNAME". 

READS PROGNAME.ASM. UPON EXITING, LEAVES NEW FILE AS .ASM, 
ORIGINAL FILE AS .BAK. REQUIRES MAC AND ABOVE LIBRARIES. 


UNLOAD - CONVERT A .COM FILE TO A .HEX FILE. INVOKED BY: 
A>UNLOAD PROGNAME ADDRESS 

INPUT EXTENSION DEFAULTS TO .COM, OUTPUT IS .HEX. 'ADDRESS' 

IS THE STARTING ADDRESS OF THE HEX FILE (DEFAULT IS 0). 


EDIT - DIS-ASSEMBLY OF EDITOR WHICH APPEARED ON A PREVIOUS DISC. 
MON], MON2, IGADD - FORTRAN-80 CALLABLE FUNCTIONS: 
MONI CALL TO BDOS WITH LOGICAL (1-BYTE) RESULT 
MON2 CALL TO BDOS WITH INTEGER (2-BYTE) RESULT 
EG: IRET=MON1 (CREG,;DEREG) 
IGADD RETURNS ADDRESS OF ITS ARGUMENT 
EG: IADD=IGADD (X) (RETURNS ADDRESS OF X) 


THESE PROGRAMS ARE CONTRIBUTED BY CACHE. 


PIRANHA.ASM A SUPER VDM GAME FROM INTERFACE AGE, 
JUST CHECK THE I/O ROUTINES, ASSEMBLE, 
AND HAVE FUN DODGING THE HUNGRY FISH. 


DEFLECT.ASM ANOTHER VDM GAME. THIS ONE INVOLVES 
MORE COORDINATION THAN PIRANHA, BUT 
IS MORE SIMPLE-MINDED IN ITS PLOT. 


MUSIC.ASM THE SOURCE OF ALPHA-NUMERIC MUSIC 
WITH AMPLITUDE CONTROL. THIS PROGRAM 
IS COPYRIGHTED, BUT FOR $1.50 YOU CAN 
GET THE DIRECTIONS FROM PCC. NO MUSIC 
TABLE IN THIS ONE. 


MUSICP.COM THE ASSEMBLED VERSION COMPLETE WITH 
MUSIC TABLE. PUT AN AM RADIO NEAR YOUR 


COMPUTER TO RUN THIS. ITS SUPPOSED TO 
RE "SOTINDS OF STT.ENCER® RY STMON AND 


ae 


708 


ROBOT.ASM 


ROBIN. ASM 


WSYSGEN.ASM 


O> 


GARFUNKEL. 


LET YOUR VDM MOONMAN BUMP AROUND THE 
BOUNDARIES OF THE SCREEN. 


THIS PROGRAM WAS WRITTEN BY A GUY IN 
PRISON TO ENABLE A GIRL WITH CEREBAL 
PALSEY TO WRITE MESSAGES ON A POLY VTI. 
PROGRAM WILL ASSEMBLE WITHOUT ERRORS, 
BUT NOT YET MODIFIED FOR MY VDM. 


WSYSGEN is a version of NSYSGEN which will ask you 
repeatedly for "DESTINATION DISK". All you do is 
continue to type A or B. It will allow you to sysgen 
a "stack" of disks at one time without reloading NSYSG 


pes 


TYPE VDM.DOC 
This note is from Ward Christensen. 


Here is some documentation which will be useful to VDM, 
VTI, Flashwriter, or other memory-mapped or 16 line 
video displays: It modifies the "P" command to scroll 
15 lines instead of 23: 


for 1.3 ED: 
AC95 MVI M,F F=15, SETS NEW LINE COUNT 


FOR 1.4 ED: 
Al161B LXI H,F 


in either case, do as follows: Either sID or DDT ED.COM, 
noting how high in memory it went (NEXT value) so you will 

know how much to save later. Then do an L command at the 
appropriate address (C95 or 161B), verifying that the 
instruction there is either an MVI M or LXI H, with the 
previous value (I believe it was 17H). Then patch in the 

new instruction. Control-C to re-boot, then save nn EDVDM.COM. 
Use this several times to be certain it is ok, then 

ERA ED.COM and REN ED.COM=EDVDM.COM. 


O> 


work 


POLY-vu 
#PV119 


K&M Company 
E. CA 99503 


TORRANC 


S 


o 


-CATALOG030 1K 
BASCOM LIT 2K 
BASIC COM 12K 
BASIC PLM 39K 
BASPAR PLM 14K 
BASSYN PLM. 54K 
BUILD PLM 17K 
RUN COM 12K 
RUN PLM 66K 
9 file(s). 


45 directory entries remaining. 
C>ss 

SS? - 

C>STAT O: 

Bytes Remaining On O: 24k 


C>TYPE O:-CATALOG. 030 
VOLUME 30 


CPMUG vol. 30 10/19/85 


CP/M BASIC-E VERSION 1.4 PLM SOURCE 
(OBTAIN VOL 29 ALSO FOR COMPLETE SET) 


NUMBER SIZE NAME 


CATALOG .30 
30.1 - 2K BASCOM.LIT 
30.2 39K BASIC. PLM 
-30.3 14k BASPAR. PLM 
30.4 54K BASSYN. PLM 
30.5 12K BASIC.COM 
30.6 66K RUN. PLM 
30.7 12K RUN.COM 


30.8 17K BUILD. PLM 


Cc> 


COMMENTS 


CONTENTS OF CP/M GROUP VOLUME 30 

LITERAL EQUATES 

VERSION 1.4 BASIC-E COMPILER MODIFIED FOR CP/M 
PARSER MODULE 

SYMBOL TABLE AND CODE GENERATOR MODULE 
EXECUTABLE COMPILE MODULE 

RUN MODULE 

EXECUTABLE RUN MODULE 

INVOKED WHEN RUN CALLED TO BUILD 

INTERNAL TABLES FROM INT FILE 


POLY-VU 
#PV IID 


K&M Company 
TORRANGE,CA 90593 


fe) 


oO 


j 


~ea.s VO «ct 


-CATALOGO31 2K 
TBASIC 1 3K 
TBASIC 10 3K 
TBASIC 11 3K 
TBASIC 12 2K 
TBASIC 13 2K 
TBASIC 14 2K 
TBASIC 15 2K 
TBASIC 2 2K 
TBASIC 3 3K 
TBASIC 4 3K 
TBASIC 5 3K 
TBASIC 6 3K 
TBASIC 7 4k 
TBASIC 8 3K 
TBASIC 9 2K 
TBASIC A 3K 
TBASIC AD 3K 
TBASIC B1 3K 
TBASIC Be 3K 
TBASIC C 3K 
TBASIC COM 21K 
More.. 

TBASIC CPM 3K 
TBASIC D1 2K 
TBASIC D2 2K 
TBASIC E 3K 
TBASIC H 1K 
TBASIC I 3K 
TBASIC' IND 3K 
TBASIC J 2K 
TBASIC K 1K 
TBASIC TOC 2K 
TBASICA4ASM 43K 
TBASICA5ASM 55K 
TBASICA6ASM 26K 
35 file(s). 

22 directory entries remaining. 
A>STAT O: 


Bytes Remaining On O: 17k 


A> CPMUG vol. 32 
~CATALOGO32 1K 

READ ME 1K 

RTMASM COM 10K 

RTMASM DOC 3K 

TBASICA1ASM 26K 

TBASICA2ASM 47K 

TBASICA3ASM 53K 

TBASICIOASM 19K 

8 file(s). 

49 directory entries remaining. 
A>STAT O: 


Bytes Remaining On O: 81k 
A> 


e 


f ftw 


6/12/85 


TYPE 0:-CATALOG.031 
VOLUME 31 


TARBELL BASIC MANUAL AND ASSEMBLER SOURCE 
(OBTAIN VOLUME 32 ALSO FOR COMPLETE PACKAGE) 


NUMBER 


oOooONnNoOaoa non = 


. 


10 


OHONOWWAWWNWHHWWW WwW 
SE a CC a Ce Cee Ce 


31.14 


SIZE 


NAME 


TBASIC.TOC 
TBASIC.1 
TBASIC.2 
TBASIC.3 
TBASIC .4 
TBASIC.5 
TBASIC.6 
TBASIC.7 
TBASIC.8 
TBASIC.9 
TBASIC.10 
TBASIC.11 
TBASIC .12 
TBASIC .13 
TBASIC .14 
TBASIC .15 
TBASIC.A 
TBASIC .B1 
TBASIC .Be 
TBASIC.C 
TBASIC .D1 
TBASIC .D2 
TBASIC.E 
TBASIC.H 
TBASIC.1I 
TBASIC wd 
TBASIC .K 
TBASIC .IND 
TBASIC .AD 
TBASIC .CPM 
TBASIC .COM 
TBASICA4.ASM 
TBASICAS .ASM 
TBASICAE .ASM 


A>TYPE 0:-CATALOG.032 


COMMENTS 


TABLE OF CONTENTS 


CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
CHAPTER 
APPENDIX 
APPENDIX 
APPENDIX 
APPENDIX 
APPENDIX 
APPENDIX 
APPENDIX 
APPENDIX 
APPENDIX 
APPENDIX 
APPENDIX 
INDEX 


PRODUCT DESCRIPTION 
SPECIAL INSTRUCTIONS 


woOOoNnNoOapoan- 


ACHIMOVOWW 


EXECUTABLE MODULE 
SOURCE MODULE 
SOURCE MODULE 
SOURCE MODULE 


VOLUME 32 


TARBELL BASIC. ASSEMBLER SOURCE 
(OBTAIN VOL 31 ALSO FOR COMPLETE SET) 


NUMBER SIZE NAME COMMENTS 

32.1 1K READ .ME NOTE FROM TARBELL ELECTRONICS 
32.2 10K RTMASM.COM MULTI INPUT FILE ASSEMBLER 
32.3 3K RTMASM .DOC INSTRUCTIONS FOR ASSEMBLING 
32.4 26K TBASICA1 .ASM SOURCE MODULE 

32.5 47K TBASICA2.ASM SOURCE MODULE 

32.6 53K TBASICA3 .ASM SOURCE MODULE 

32.7 19K TBASICIO.ASM SOURCE MODULE 


A> 


POLY-vu . 
HPV TID 


K&M Company 
TORRANCE, CA 90503 


e-) 


oO 


J 


-CATALOG041 
ABSTRACTO41 
BMAINT BAS 
BREPORT BAS 
CHESS COM 
CHESS Doc 
CHESS FOR 
CODE BAS 
HAMPROGSDOC 
LABELS’ BAS 
MOONLOC DOC 
MOONLOC1BAS 
MOONLOC 2BAS 
MOONLOC3BAS 
MOONLOC5BAS 
MORSE ASM 
PONG ASM 
PRACTICEASM 
RANDTEXTBAS 
RESIZE DOC 
RESIZE2 BAS 
RESIZE3 BAS 


More.. 

RTTY ASM 
SSPLIB FOR 
TEACH ASM 
TTY ASM 
TTYR ASM 
TTYR1 ASM 
TTYX ASM 
UGFORM 

30 file(s). 


CPMUG vol. 


31 directory entries remaining. 


D>STAT O: 


Bytes Remaining On O: 12k 


D> 


41 


1/86 


TYPE O:-CATALOG,. 041 
VOLUME 41 


(1) Ham radio programs 
(2) Chess program 

(3) VDM Pong program 
(4) Fortran least squares curve fitting program 


NUMBER’ SIZE 


41.1 
41.2 
41.3 
41.4 
41.5 
41.6 
41.7 


41.8 

41.9 

41.10 
41.11 
41.12 
41.13 
41.14 
41.15 


41.16 
41.17 
41.18 
41.19 
41.20 
41.21 
41.22 


41.23 
41.24 
41.25 
41.26 
41.27 


D> 


NAME 


~CATALOG.041 
ABSTRACT.041 
BMAINT.BAS 
BREPORT.BAS 
CHESS.COM 
CHESS.DOC 
CHESS.FOR 
CODE.BAS 
HAMPROGS.DOC 


LABELS.BAS 
MOONLOC.DOC 
MOONLOC1 . BAS 
MOONLOC2.BAS 
MOONLOC3.BAS 
MOONLOCS5.BAS 
MORSE. ASM 
PONG.ASM 


PRACTICE.ASM 
RANDTEXT.BAS 
RESIZE.DOC 
RESIZE2.BAS 
RESIZE3.BAS 
RTTY.ASM 
SSPLIB.FOR 


TEACH.ASM 
TTY.ASM 
TTYR.ASM 
TTYR1.ASM 
TTYX.ASM 


COMMENTS 


CONTENTS OF CP/M VOL. 41 
Abstracts on some files 


(1) 
(1) 
(2) 
(2) 
(2) 
(1) 
(1) 


(1) 
(1) 


(1) 
(3) 


(1) 
(1) 
(1) 
(1) 
(1) 
(1) 
(4) 


(1) 
(1) 
(1) 
(1) 
(1) 


Ham maillist maint. BASIC/E 
Ham maillist report 

COM of 41.5 

DOC on chess program 
Cromemco Z-80 Fortran Chess 
Simple Morse code receiver 
Doc on BMAINT, BREPORT, 
RTTY, etc. 

Print return labels 

Doc on 41.10-41.13 which 
are various versions of 
programs to locate the 
moon's position to do 

moon bounces 

Morse send/receive prog. 
PONG for the VDM (re- 
release of CP/M U.G. 6.9) 
Morse code teacher 

Generate text for 41.16 
Part of ham maillist system 
Part of ham maillist system 
Part of ham maillist system 
RTTY send receive program 
Curve fitter/simultaneous 
linear equation solver. 
Morse Code teaching prog. 
Baudot-coded-ASCII to ASCII 
Variation of 41.24 
Variation of 41.24 

Xmit ASCII via conversion 
to Baudot-coded-ASCII 


TYPE O: ABSTRACT. 041 
~------------------- VOLUME 41 ABSTRACTS --~-~------------------ 


TITLE: HAM RADIO, CHESS, ASSEMBLER GAMES 


CHESS.COM ABSTRACT 12/25/79 

Typical Application: A friendly game of computer chess. 

i+) Memory Requirements: 40K CP/M System. 

There was no documentation provided with this program. 
There is a CACHE-generated .DOC file which details the 
command format and message outputs. There are also 
some comments on the comparison tests I ran between 
CHESS.COM & Fidelity Electronics' Chess Challenger 7. 
There is no modification necessary to run CHESS.COM in 
a standard CP/M system. 

Overall, this seems to be a fairly well-done chess 
program that will give you some challenging games. 
Have fun! 

Jim Millis, C.A.C.H.E. Member 


ABSTRACT FOR CODE.BAS WRITTEN BY WARD CHRISTENSEN 
MBASIC MORSE CODE RECEIVE PROGRAM 


This is a very short program that should run in just about any 
size memory that supports CP/M. It does require a hardware 
interface between the computer and radio receiver. As usual, 
Ward's programs are well written. 

Jim Mills WBOKFP 

CACHE Member 


ABSTRACT FOR LABELS.ABS Written by James K. Mills 
PROGRAM TO PRINT RETURN ADDRESS LABELS 


Oris program was written for return address labels, but I have 
also found it useful for making other address labels out to 
mail to others -- especially if you need 4 or 5 labels for 
different envelopes or packages. This program is very short 
and should run in just about any system supporting CP/M. 


Jim MIlls 
CACHE Member 


ABSTRACT FOR THE MOONLOC (Moon Location) PROGRAMS 
MOONLOC1.BAS, MOONLOC2.BAS, MOONLOC3.BAS & MOONLOC4.BAS 

Memory Requirements: 36K CP/M System. 

These programs were initially designed for a GE timesharing 
computer using GE BASIC and GE TYMSHARE SUPERBASIC (look at 
the code for a good laugh). The most valuable program for 
those Amateur Radio Operators desiring to work EME (Earth- 
Moon~Earth) "Moonbounce" will be MOONLOCS5.BAS which is 

written for MITS Altair Basic and should modify to MBASIC 

or even BASIC-E with little difficulty. 

Programs 1 and 2 require a Nautical Almanac (do you have one?). 
Program 5 was modeled after program 3 which uses pre-dated 
almanac data and increments to the present date. The programs 
output the moon's elevation and direction for specified times 
in specified time increments. James K. Mills WBOKFP 

CACHE Member 


Oni. oct 1976 page 57 
ABSTRACT FOR MORSE.ABS 
uy! MORSE CODE TRANSCEIVE PROGRAM 
| This program sends and receives Morse Code using appropriate 
hardware interfacing to an Amateur Radio Station. This program 
should run in a 20K CP/M svstem hut it mav reqii:s 9. ° he 


agetai.S can be found in Byte magazine, Oct 14/9, page s/. 


James K. Mills WB9KFP 
CACHE Member 


PONG.ASM is the assembler source for a game program which 
simulates the electronic TV game called "PONG". It can be 
ssembled with ASM. It requires a Processor Technonlog VDM or 
SOL for the display of the ball and paddles. It was submitted 
to the users group earlier, but the file got clobbered 
somewhere along the way. The source was written by one person 
(poorly sturctured and without comments and with non-standard 
op codes) and was disassembled back into standard op codes) 
and extensivly modified by someone else (which didn't help the 
quality), making it difficult to modify. In its present state, 
it is useful for an enjoyable game of PONG. Adult tire of it 
quickly but kids love it. Reviewed by Robert A. Van Valzah. 


ABSTRACT FOR PRACTICE.ASM Written by James K. Mills 
MORSE CODE PRACTICE PROGRAM 

Memory requirement: 24K CP/M System. 

REQUIRES Digital Research MAC Macro Assembler. 

This program was modelled after Bob Van Valzah's 
TEACH program, but differs in that this program sends 
text files (from disk) in Morse Code. The speed is 
set at about 15 WPM but may be changed by modifying 
the WPM EQU statement in the program. 

Invocation is PRACTICE FILENAME.TYP. 

Appropriate hardware is necessary to generate 
the tone. 

James K. Mills WB9KFP 
CACHE Member 


Qassrracr FOR RANDTEXT.BAS Written By James K. Mills 
RANDOM TEXT GENERATION PROGRAM 


This program was written to go along with PRACTICE.ASM 
for the purpose of generating random characters for 
Morse Code Practice. The program generates 5-letter 
code groups of letters, numerals, and punctuation. 


RANDTEXT should run ok in a 32K CP/M System. 


James K. Mills WB9KFP 
CACHE Member 


ABSTRACT for RESIZE2.BAS & RESIZE3.BAS 
Written by James K. Mills For Ward's Maillist Programs 
Program requirements: CP/M System with Basic-E 
Memory Requirements: Minimum of 32K, 48K preferred. 
This program is used to resize maillist files used 
with Ward's maillist program. It will change the size 
and, if modified in one line, will re-key the file for 
Amateur Radio Club use: keying by call-sign rather than 
by name. The program has some slight advantage over 
Ward's RESIZE program in that 100 records are buffered 
in memory rather than one record at a time. This may 
be a liability if you don't have much memory, but it 
Opry requres a slight change to buffer fewer records. 
s"For use with Ward's original Maillist programs, see 
RESIZE.DOC, included on this disk. 
ul James K. Mills 
“ CACHE Member 


ABSTRACT FOR RTTY.ASM 
RADIO-TELETYPE TRANSCEIVE PROGRAM 


Memory Requirements: 
RTTY is a program for transmission/reception of 
Amateur Radio RTTY signals. Appropriate hardware 

is required to interface to an Amateur Radio Station. 
This program was developed from TTY.ASM, TTYR.ASM, 
and TTYX.ASM which are included on this 


TTYR1.ASM, 
disk for reference. 
here are very few comments in the Source Code. 
This may make modifications for less experienced 
assembly language programmers difficult. 

The program has some nice features, such as dumping 
received signals to disk files, etc. 


24K CP/M System. 


James K. Mills WB9KFP 
CACHE Member 


SSPLIB.FOR contains FORTRAN source for a set of subroutines for 
solving simultaneous linear equations, curve fitting, function 
plotting, fast sorting, matrix inversion, and linear equation 
These routines could not be tested as I do not have 
The info contained herein came with the 


solution. 


a FORTRAN compiler. 


submission of these routines to the users group. Reviewed by 


Robert A. Van Valzah. 


ABSTRACT FOR TEACH.ASM 


Teach Morse Code Program 


Memory requirements: 24K CP/M System. 
This program is designed to teach Morse Code to someone who 
does not already know the code. It is fairly well written 
and has the nice feature of giving a bar-graph of how well 
you have done on each character. It may be used for practice 
for more speed of reception if you are a good typist. 
Appropriate hardware is necessary to generate the one. A 
single bit output port connected to an amplifier and speaker 
ill do. 


D>TYPE O:CHESS.DOC. 
CHESS.DOC DOCUMENTATION FOR CHESS.COM 
(SOURCE CODE WRITTEN IN FORTRAN) 


DECEMBER 25, 1979 


James K. Mills WBOKFP 
CACHE Member 


CHESS.COM USES ALGEBRAIC NOTATION AND A BOARD DISPLAY 
SIMILAR TO MICROCHESS: 


A B C D E F G &# 


BR 
BP 


WP 
WR 
A 


Rh WB UI O~] © 
. 
° 


HERE 


BN 
BP 


BQ 
BP 


BK 
BP 


BB 
BP 


BN 
BP 


BR 8 
BP 7 
s: «6 
-- 5 
s: (4 
-- 3 
WP 2 
WR 1 


ARE TWO OTHER COMMANDS WHICH DISPLAY THE BOARD 
AND ASK THE COMPUTER IF IT WILL ACCEPT A DRAW. THEY 
ARE "BOARD" AND "DRAW", RESPECTIVELY. 


ul! 
‘ TO CASTLE KING-SIDE, TYPE IN 0-0 
TO CASTLE QUEEN-SIDE TYPE IN 0-00 


IF YOU TRY O-0-O IT SAYS 


"ILLEGAL ATTEMPT TO CASTLE" 


ALWAYS USE CAPITAL LETTERS, FORTRAN-CHESS DOES NOT 
ACCEPT LOWER CASE. 


I HAVE RUN SEVERAL GAMES COMPARING THE FORTRAN-CHESS (FC) 
PROGRAM AGAINST FIDELITY ELECTRONICS' CHESS CHALLENGER 7 (CC7) 
(C) 1978 FIDELITY ELECTRONICS. WITH FC AT LEVEL 0 (IT ONLY 
HAS 0 AND 1) AND CC7 AT LEVEL 1 (CC7 HAS 6 LEVELS OF PLAY) 

C WINS. WITH FC AT LEVEL 0 AND CC7 AT LEVEL 2 CC7 WINS. 
FC'S RESPONSE TIME AT LEVEL 0 VARIES BUT IS NEVER MORE THAN 
90 SECONDS. I HAVE NOT YET CLOCKED IT AT LEVEL 1, BUT 
IT HAS A SIGNIFICANTLY LONGER RESPONSE TIME (AT LEAST 
AS MUCH AS SEVERAL MINUTES -- ESTIMATION). 


HAVE FUN! 


JIM MILLS 
C.A.C.H.E. MEMBER 


D>TYPE HAMPROGS .DOC 
HAMPROGS .DOC? 


D>TYPE O:HAMPROGS.DOC 
HAMPROGS.. DOC 
HAM RADIO PROGRAMS DOCUMENTATION 
DECEMBER 31, 1979 


James K. Mills WB9KFP 

Ham Radio Special Interest Group Co-ordinator 
Chicago Area Computer Hobbyist Exchange 

P. 0. Box 94864 

Schaumburg, IL 60194 


6: BMAINT.BAS and BREPORT.BAS are modifications of Ward 
hris 


A 


4 


tensen's maillist programs for use by Amateur Radio Clubs. 
The KEY is now by call-sign instead of by name -- this is much 
more convenient for Amateur Radio Clubs where one usually knows 
the individual's call-sign better than his name. The keying 
algorithm is changed not only for the call-sign, but also to 
allow any number of records up to the maximum of 1920 (15 
extents) per disk. 


LABELS.BAS is a small BASIC-E program to print return 
address labels (or whatever you want to use them for). Asks 
for name, organization, street, city-state and zip. Prints out 
2 to 100 labels (you can change the limits). 


TEACH.ASM is the predecessor to my own PRACTICE.ASM 
documented below. TEACH is for those first learning the Morse 
Code. It sends a character, then waits for a response and then 
another, and so on. It will give you a bar graph of your speed 
and correctness of responses. Source code is 10K. Needs 
hardware to be able to generate tone. 


PRACTICE.ASM and RANDTEXT.BAS are for use in order to 
practice morse code. Some type of hardware is necessary to 
generate a tone which can be controlled by the computer. 


; CODE.BAS is Ward Christensen's MBASIC Morse code receive 
program. You will need hardware to interface your radio to the 
computer. 


MORSE.ASM is a Morse Code send/receive program. Again, 
hardware interface is required to couple radio to computer. 
Source code is 8K. 


RTTY.ASM is a Ham RTTY (5-level Baudot Code) send/receive 


4 


program wit: some nice features. It waS caeve:opeaq from tne 
TTY*.ASM files which are also included on this disk for 
reference. 


Jim Mills WB9KFP 


D>TYPE O:MOONLOC.DOC 
COMPUTER PROGRAMS FOR LOCATING THE MOON 


EIMAC DIVISION OF VARIAN 
301 INDUSTRIAL WAY 
SAN CARLOS, CALIFORNIA 


In two previous issues of the Eimac EME notes, methods 
were described for determining antenna aiming data to "hit" the 
moon. In bulletin AS-49, there was a reprint of an article by 
Don Lund, WAOIQN, an article by Victor Michael, W3SDZ, and some 
letters to the technical editor of QST from Alan Goodacre, 
VE3BZS, all discussing antenna aiming. Also, in bulletin 
AS-49-1 more information on aiming data was presented. 
Bulletin AS-49-1 stressed the use of the Nautical Almanac and 
the Hydrographic Office publication HO-214. It is possible to 
determine the moon's position by means of those two 
publications without extensive mathematics. However, as one 
becomes more involved in the EME project, the habits of the 
moon become interesting. Also, more sophisticated methods of 
tracking the moon become attractive. 


For those persons having access to handheld scientific 
calculators, new techniques become available. For those 
Amateurs having access to a computer, either punch-card or an 
active terminal, another interesting hobby of writing and 


a a programs develops. 


In this issue of the EME notes, four programs are 
presented which may be of interest. One is in BASIC, two are 
in TYMSHARE SUPERBASIC and one in TYMSHARE SUPERFORTRAN. As is 
usually the case, these programs will probably need to be 
modified to run on the machine available to the individual 
amateur. 


PROGRAM 1 [MOONLOC1.BAS] 
LANGUAGE: BASIC 


This program will run on almost all machines accepting 
BASIC. The operator must put in data from the Nautical Almanac 
for the year, month, day and hours that the elevation and 
azimuth is desired. Also, the latitude and longitude of the 
geographic location in question must be entered. Statement 20 
allows the operator to put in the time interval, in minutes, 
between each calculation. 


The origin of this program is not known. 


PROGRAM 2 [MOONLOC2.BAS] 
LANGUAGE: TYMSHARE SUPERBASIC 


The program is a modified version of program 1. The 


Qrutput format is slightly different. Also, limits can be put 
on 


the azimuth and elevation angles at the operator's 
discretion. The program requires latitude and longitude and 
time interval inputs. Also, Nautical Almanac data for the 
year, month, day and hours must be put into the data 
statements. Statement 610 allows the operator to put the data 
in for identification. The computer does not use this 
statement in the calculations. The computer will pause and let 


you type ain tie date. when inserting tne aate, ao not use 
commas for seperating the month, day, and year. If you do, the 
computer will become confused. When the carriage return is 
depressed the computer will carry on. 


PROGRAM 3 [MOONLOC3.BAS] 
LANGUAGE: TYMSHARE SUPERBASIC 


° This program was originally written in BASIC by Lance 
Collister, WA3GPL. However, the BASIC used on the General 
Electric terminal was sufficiently different from the TYMSHARE 
SUPERBASIC that the program would not run. A few modifications 
were made to allow the TYMSHARE machine to run. What is 
presented here will not run on the GE computer. Perhaps those 
who attempt to use this program will have to make further 
changes for their individual cases. 


The program is very useful because no almanac data is 
required. The program allows the calculation of the moon 
position by comparing back to the position of the moon at the 
start of the Julian calendar. The operator need put in only 
the latitude, longitude, time interval, month, day, year and 
hours between which aiming data is required. If rising, or 
setting, moon calculations are required, the computer 
determines the time and will execute the printout requested. 


PROGRAM 4 [MOONLOC4.FOR] 
LANGUAGE: TYMSHARE SUPERFORTRAN 


This program was supplied by Louis Anciaux, WB6NMT. As 
received, the program was on tape and written in FORTRAN IV. 
Again, the program was modified to run with TYMSHARE 
SUPERFORTRAN, This program requires nautical almanac data. 

owever the GHA and declination for 0000, 0600, 1200, 1800, and 

2400 hours GMT is all that is required. The program will 
interpolate for all othe times. Of course, the latitude, 
longitude, and time interval for the calculation must be typed 
in. 


PROGRAM 5 [MOONLOC5.BAS] 
LANGUAGE: MITS ALTAIR BASIC 


This program is a version of Lance Collister's (WB7CCI) 
original moon tracking program written in GE BASIC. This 
particular version was modified by Jay Liebmann, K5JL, to run 
on a MITS Altair 8800B. The program requires about 6700 Bytes 
of memory. 


D>TYPE O:RESIZE.DOC 
RESIZE.DOC 
Documentation for RESIZE2.BAS & RESIZE3.BAS 
01/02/80 


RESIZE is a file reconfiguration program for Ward 
Christensen's Maillist programs written in BASIC-E (RESIZE3 
modified by myself for use by Ham Radio Clubs.) Use RESIZE2 
for files keyed on the name, RESIZE3 for files keyed on Amateur 
Radio Call-sign. RESIZE re-sizes the file. For example, if 

ou have 128 records and find yourself with a need for more, 
you may use RESIZE to convert the file to a different size. It 
is a good idea to use increments of 128 since CP/M sets up 
uo directories 128 sectors at a time. 


You will be prompted for the filenames and new file 
length. The program will take a certain amount of time to run 
since it has to perform a qreat many disk accesses. If you are 


converting from a “name Key’ format to a “call-Sign xey format 
using RESIZE3, changing the READ #1 statement after line ll 
will enable you to re-key on call-signs. Just reverse the 
NAMES(N) and CALLS(N) fields. The file will be re-written 
indexed by call-sign. 


James K. Mills WB9KFP 


we) CACHE Member 


BE yaa 


D> 


CPMUG vol. 43 ~ 7/27/85 


-~CATALOG043 2K 
A/P-INFOBAS 1K 
A/P000 BAS 1K 
A/P010 BAS 13K 
A/P02A BAS 4K 
A/P02B BAS 6K 
A/P030 BAS 12K 
A/P040 BAS 11K 
A/P050 BAS 6K 
A/P060 BAS 7K 
A/P070 BAS 11K 
A/P080 BAS 2K 
A/P090 BAS 11K 
A/P110 BAS 5K 
A/P120 BAS 10K 
A/R-INFOBAS 2K 
A/R-INV BAS 1K 
A/RO10 BAS 12K 
A/R0O20. BAS 5K 
A/RO3A_ BAS 4K 
A/RO3B-. BAS 12K" 
A/R040 BAS 9K 
More.. 
A/RO50. BAS 11K 
A/RO60 BAS 2K 
A/RO70. BAS 9K 
A/RO80 BAS 5K 
A/RTAX BAS 2K 
ABSTRACT043 1K 
BINSEARCBAS 1K 
CRTFM BAS 10K 
CURSOR BAS 2K 
FILEINITBAS 2K 
G/L-INFOBAS 1K 
GENINFO BAS 2K 
PIP COM 8K 
READCUSTBAS 1K 
READINV BAS 1K 
READVENDBAS 1K 
SUBS1 BAS 5K 
PS U-G-FORMLIB 4K 
2 WRITCUSTBAS 1K 
pa WRITEINVBAS 2K 
g WRITEVNDBAS 1K 


43 file(s). 
' 21 directory entries remaining. 
A>STAT O: 


K&M Company 


TORRANCE, 


Bytes Remaining On O: 22k 


A> 


CPMUG vol. 44 7/27/85 


-CATALOG044 3K 
ABSTRACT044 3K 
ACCTFILEBAS 2K 
ANNTOT1 BAS 5K 
ANNTOT1 INT 3K 
BINSERCHBAS 1K 
BUDGET] BAS. 12K 
BUDGET] DOC 2K 
BUDGET1 INT 6K 
BUDGETCHBAS 5K 
BUDGETCHINT 2K 
CBAS SUB 1K 
CRTIFM BAS 10K 
CRIFM INT 4k 
CURSOR BAS 2K 
EXP1980 TOT 2K 
EXPENS80JAN 1K 
FILEINITBAS 1K 
FILEINITINT 1K 
G/L DOC 2K 
G/L-INFOBAS 2K 
G/L000 BAS 1K 
More.. 

G/L000 INT 2K 
G/L010_ BAS 6K 
G/L010 INT 4k 
G/L020 BAS 6K 
G/L020 INT 2K 
G/L030 BAS 6K 
G/L030 INT 5K 
G/L040 BAS 9K 
G/L040 INT 6K 
G/LO050 BAS 12K 
G/L050 INT 6K 
G/L070 BAS 5K 
G/LO70 INT 4K 
G/L080 BAS 8K 
G/LO80 INT 5K 
GENINFO BAS 1K 
LEDGER1 BAS 7K 
LEDGER1 DOC 2K 
LEDGER] INT 3K 
POSTFILEBAS 2K 
ROBO - BAS 3K 
ROBO DOC 1K 
More.. 

ROBO INT 2K 
SUBS1 BAS 5K 
TCGwWO2 TXT OK 
47 file(s). 

17 directory entries remaining. 
A>STAT O: 


Bytes Remaining On O: 58k 
A> 


TYPE O:-CATALOG.043 


VOLUME 43 


DESCRIPTION: OSBORNE CBASIC2 ACCOUNTS PAYABLE AND 
ACCOUNTS RECEIVABLE BUSINESS SOFTWARE PROGRAMS. 


NUMBER SIZE 


NAME 


CATALOG. 43 
A/P-INFO.BAS 
A/P000.BAS 
A/P010.BAS 
A/P02A.BAS 
A/P02B.BAS 
A/P030.BAS 
A/P040.BAS 
A/P050.BAS 
A/P060.BAS 
A/P070.BAS 
A/P080.BAS 
A/P090.BAS 
A/P110.BAS 
A/P120.BAS 
A/R-INFO.BAS 
A/R-INV.BAS 
A/RO10.BAS 
A/R020.BAS 
A/RO3A.BAS 
A/R03B.BAS 
A/R040.BAS 
A/R050.BAS 
A/R060.BAS 
A/R070.BAS 
A/R080.BAS 
A/RTAX.BAS 
ABSTRACT. 043 
BINSEARC.BAS 
CRTFM.BAS 
CURSOR.BAS 
FILEINIT.BAS 
G/L~-INFO.BAS 
GENINFO.BAS 
READCUST.BAS 
READINV. BAS 
READVEND.BAS 
SUBS1.BAS 
WRITCUST.BAS 
WRITEINV.BAS 
WRITEVND.BAS 


43.1 1K 
43.2 1K 
43.3 13K 
43.4 4K 
43.5 6K 
43.6 12K 
43.7 11K 
43.8 6K 
43.9 7K 
43.10 11K 
43.11 2K 
43.12 11K 
43.13 5K 
43.14 10K 
43.15 2K 
43.16 1K 
43.17 12k 
43.18 5K 
43.19 4k 
43.20 12K 
43.21 9K 
43.22 11K 
43.23 2K 
43.24 9K 
43.25 5K 
43.26 2K 
43.27 1K 
43.28 1K 
43.29 10K 
43.30 2K 
43.31 2K 
43.32 1K 
43.33 2K 
43.34 1K 
43.35 1K 
43.36 1K 
43.37 5K 
43.38 1K 
43.39 2K 
43.40 1K 
A>TYPE O:-CATALOG.044 
VOLUME 44 
DESCRIPTION: 


COMMENTS 


CONTENTS OF CP/M VOL. 43 
Part of A/P-A/R Package. 


ssss 


Abstracts of A/P-A/R Programs. 
Part of A/P-A/R Package. 


CBASIC2 PROGRAMS 


Osborne/McGraw-Hill General Ledger Programs. 


Documented in: 


the above documentation. 


General Ledger, CBASIC 


OSBORNE/McGraw-Hill 

630 Bancroft Way 

Berkeley, CA. 94710 

Don't seriously attempt to use these programs without 


See your local computer 


store, Or some of the larger metropolitan book stores. 


and from Pat Cunningham: 


Rul-a 


at-ae De ewe 


= 1 ROBO Math: Game. 


NUMBER SIZE 


44.1 3K 
44.2 2K 
44.3 5K 
44,4 3K 
44.5 1K 
44.6 12K 
44.7 2K 
44.8 6K 
44.9 5K 
44.10 2K 
44.11 1K 
44.12 10K 
44.13 4k 
44.14 2K 
44.15 2K 
44.16 1K 
44.17 1K 
44.18 1K 
44.19 2K 
44.20 2K 
44.21 1K 
44.22 2K 
44.23 6K 
44.24 4K 
44.25 6K 
44.26 2K 
44.27 6K 
44.28 5K 
44.29 9K 
44.30 6K 
44.31 12K 
44.32 6K 
44.33 5K 
44.34 4K 
44.35 8k 
44.36 5K 
44.37 1K 
44.38 7K 
44.39 2K 
44.40 3K 
44.4] 2K 
44.42 3K 
44.43 1K 
44.44 2K 
44.45 5K 
44.46 OK 


* one anonymous 


A> 


NAME 


CATALOG. 44 
ABSTRACT.044 
ACCTFILE.BAS 
ANNTOT1.BAS 
ANNTOT1.INT 
BINSERCH.BAS 
BUDGET1.BAS 
BUDGET1.DOC 
BUDGET].INT 
BUDGETCH. BAS 
BUDGETCH.INT 
CBAS.SUB 


CRTFM.BAS 


CRTFM.INT 
CURSOR.BAS 
EXP1980.TOT 
EXPENS80.JAN 
FILEINIT.BAS 


FILEINIT.INT 
G/L.DOC 
G/L-INFO.BAS 
G/L000.BAS 
G/L000. INT 
G/L010.BAS 
G/L010.INT 
G/L020.BAS 
G/L020.INT 
G/L030.BAS 
G/L030.INT 
G/L040.BAS 
G/L040.INT 
G/L050.BAS 
G/L050.1INT 
G/L070.BAS 
G/L070.INT 
G/L080.BAS 
G/L080.INT 
GENINFO.BAS 
LEDGER1.BAS 
LEDGER1.DOC 
LEDGER]. INT 
POSTFILE.BAS 
ROBO.BAS 
ROBO .DOC 
ROBO. INT 
SUBS1.BAS 
TCGWOZ .TXT 


COMMENTS 


CONTENTS OF CP/M VOL. 44 
Comments on contents of volume. 
Part of Osborne General Ledger. 
Part of Cunningham Ledger. 

INT of above file. 

Part of Osborne General Ledger. 
Part of Cunningham Budget. 

DOC of above file. 

INT of above file. 

Part of Cunningham Budget. 

INT of above file. 

SUBMIT file for compiling the 
Osborne programs. 

CRT File Maint. Utility for 
Osborne General Ledger. 

INT of above file. 

Part of Osborne General Ledger. 
Cunningham Budget Data file. 
Cunningham Budget Data file. 
Utility for Osborne General 
Ledger. 

INT of above file. 

DOC on Osborne General Ledger. 


Part of Osborne General Ledger. 
n 


sssss3 3s 333232833838 


Cunningham Ledger. 

DOC of above file. 

INT of above file. 

Part of Osborne General Ledger. 
Cunningham Math Game. 

DOC of above file. 

INT of above file. 

Part of Osborne General Ledger. 
Collected Great Works of Zoso * 


reviewers satirical opinion. 


TYPE O:ABSTRACT.043 

Programs: Osborne Accounts Payable/Accounts Receivable Package. 
Keeps track of current Payables & Receivables, as well as 
ageings and payments against both. 
Requirements: 40K CP/M SYSTEM; CBASIC2. 
The following programs did not compile (as given): 

A/R-INV.BAS READCUST.BAS 

GENINFO.BAS A/RTAX.BAS 

WRITCUST.BAS READINV.BAS 

WRITEINV.BAS WRITEVND.BAS 
And there are known bugs that you will have to work out. 
Documentation: Osborne/McGraw-Hill "Accounts Payable & 
Accounts Receivable (CBASIC)" by Lon Poole, Mary Borchers, 
Martin McNiff, Robert Thompson. 358 Pages. The documentation 
is very comprehensive. Changes will be required in some 
programs if other than a Hazeltine terminal is used. 
Larry Root, Richton Park, Illinois 


A> 


TYPE O:ABSTRACT.044 
wn ----------- === VOLUME 44 ABSTRACTS ---------------- 


PROGRAMS: BUDGETI1 --ENTERS BUDGET INFO TO FILE 
LEDGERI1 --TOTALS MONTH FILE AND REPORTS 
ANNTOT1 ~-REPORTS THE YEAR TO DATE 


BUDGETCH --CHANGE FILE INFORMATION (ERRORS) 
AUTHOR: PAT CUNNINGHAM, SAN ANTONIO, TX 
SOFTWARE: CBASIC 
HARDWARE: 96 COL. OR GREATER PRINTER IF YOU WISH HARDCOPY 
DOC FILES: LEDGER1.DOC & BUDGET1.DOC 
The program is nicely written with good commenting. All of 
the programs run and seem to work properly. Error trapping 
could be improved. LEDGER] allows a rerun at the end, but 
this bombed for me. The main weakness of the program is the 
inadequate user prompts. The BUDGETCH expects the user to 
remember the 20 letter that reference the expense catagories. 
The catagory discriptions are available as a user call from 
the BUDGET] program. It would be an improvement if the 
program provided the information without request in both 
BUDGET1 and BUDGETCH. All in all--a usable program to enter 
monthly expense forthe home--after you get use to the required 
input formats. LEDGER] sign-off is a reference to a mythical 
state--somewhat akin to Camalot combined with Devil's Island. 

Reviewer: Ken Prevo of CACHE 


PROGRAM: ROBO 
AUTHOR: PATRICK CUNNINGHAM, SAN ANTONIO, TX 
SOFTWARE: CBASIC 
HARDWARE: NO SPECIAL REQUIREMENTS 
DOC FILE: ROBO.DOC 

ROBO is a math drill (addition) for preschoolers and first- 
graders. It has a line of numbers provided that, I guess, save 
on the fingers and toe method I use. This might make some 
teachers unhappy. The programs is a nice little helper for 
those learning beginning math. Reviewer: Ken Prevo of CACHE 


AUTHOR: ANON 

PROGRAM: THE COLLECTED GREAT WORKS OF ZOSO 

FILE LENGTH: OK 

It is rumored the sequel will be THE INANE REMARKS OF ZOSO THE 
GREAT. A reviewer is currently being solicited. Anyone with 
quad-density interested? Reviewer: POGO 


PROGRAMS: GENERAL LEDGER 


This is the General Ledger series of programs published by 
Osborne/McGraw-Hill. It has received good reviews, it 
compiles and runs on a Hazeltine terminal, but will require 
modification if you use a different terminal. See G/L.DOC 
for further comments. Jim Mills CACHE SIG CP/M 


A> 


TYPE O:BUDGET1.DOC 
DOCUMENTATION ON BUDGET1 


BUDGET] is a source program in CBASIC (version 2) written by Patrick Cunning- 
ham of San Antonio, TX [235 Sharon Drive, San Antonio 78216]. Suggestions on 
improvements are solicited. I wrote it for a 48K ALTOS ACS8000 computer with 
dual floppy (8" or 20 cm) drives. It probably will work with less memory. 


To operate, compile the BUDGET1.BAS file using the CBASIC2 compiler. Some 
editing may be necessary to make this file compatible with other compilers. 
Prompts will be displayed whenever necessary. Run when INT file is created. 


BUDGET1 operates on 1-20 expense records, which are input by the operator. 
Each of these records may be subdivided into several (max of 4) categories. 
The program checks the addition used in allocating these categories. 

These are then output onto CP/M based disc files in records that contain 
the day of the transaction, payee, and category/amount for 1-4 categories. 
The record length is 64 characters, so that random access to the files is 
possible. The program will add new expenses to the disc immediately after 
any currrent expenses already logged. The file created should have the 
name EXPENSnn.XXX, where nn is the last two digits of the A.D. year and 

XXX is the month code, such as JAN, FEB, MAR, APR, etc. 


BUDGET] has a built-in iteration prompt that allows the user to process 
more than one month's expenses at the same time. Category codes for each 
of the nineteen categories (charity, food, mortgage, phone, etc.) are dis- 
played in a menu upon user's request. 


BUDGET1 may be freely copied for non-commercial distribution. Under no 
circumstances may it be sold for profit. (C) copyright 1980 by Patrick 
Cunningham. 

BUDGET] is accessed and totaled by the program LEDGER1. 


A> 


TYPE O:G/L.DOC 
GENERAL LEDGER DOCUMENTATION 11/06/80 


You WILL need to purchase the book GENERAL LEDGER CBASIC by 
Lon Poole, with Mary Borchers, Martin McNiff, and Robert 
Thomson. It is published by Osborne/McGraw-Hill and is 
available in many computer stores and some book stores. If 
you are unable to find it any other way, you can usually 
order it through a bookstore. 


This disk contains a file called CBAS.SUB which is a submit 
file for compiling the programs on this disk in proper 
sequence. Some of the .BAS files you see on the disk are 
not listed in the .SUB file because they are subroutine 
type programs that are loaded with the main programs using 
the CBASIC2 INCLUDE statement. 


Two of the programs on the disk, CRTFM and FILEINIT are 
utilities that you will use the first time you set up your 
data files, and used seldom after that. 


You will want to modify the CURSOR.BAS program for your CRT 

-- CURSOR.BAS is set up for a Hazeltine terminal and if you 
don't have a Hazeltine, then you'll] have to make Some changes. 
SUBS1.BAS also has some cursor positioning routines in it 

that you may need to modify. These modifications will require 
a good deal of familiarity with the manual and the operation 
of your CRT as opposed to a Hazeltine. Familiarity with 
CBASIC2 programming is also required. 


After you have compiled the programs, you will want to 
put all the .INT files on a blank disk, perhaps with CRUN2. 


Refer to the book for operating instructions. G/L000 is the 
menu program. 


Good luck. 

Jim Mills 

Chicago Area Computer Hobbyist Exchange (CACHE) 
Special Interest Group for CP/M (SIG CP/M) 


A> 


TYPE O:LEDGER1.DOC 
DOCUMENTATION ON LEDGER] 


LEDGER] is a source program in CBASIC, version 2, written by Patrick Cunning- 
ham of San Antonio, Tx. It is a companion program to the entry program, BUDGE 
also written in CBASIC2. I wrote it for a 48K ALTOS ACS8000 computer with du 
8" (20 cm) floppy drives, but it will most surely work with less memory. Som 
dimension statements take up considerable room in memory. 


The program should be compiled with the CBASIC2 compiler, or revised to work 
with whatever compiler you have on line. Then run as usual. The program 
assumes that a month's records, or some fraction of a month's records, have 
been entered in 64 character record lengths in the order DATE%, PAYEES, 
CATEGORY.CODE$(1), AMOUNT(1).....CATEGORY.CODES$ (4) ,AMOUNT(4). 


A few prompts are needed to start off the program. The program automatically 
creates new files, given the year, as EXPnnnn.TOT where nnnn is the A.D. year 
If you merely want to get totals, but not put them on disc, you can specify 
UPDATE or DISC at the appropriate prompt. You may also do more than one mont 
at a time. 


The output can be put onto the line printer by adding LPRINTER at appropriate 
places in the program. The output gives, by category, the date of payment, 
payee, and individual amount. It gives a total for each category for the 
month; it ends with a total of month's payments. The entire program takes 
about two minutes to run. 


The program is offered for non-commercial distribution. (C) copyright 1980 
by Patrick Cunningham; not to be sold for profit. 


The companion program that gives annual totals is ANNTOT1. 


A> 


TYPE O:ROBO.DOC 

ROBO. 
ROBO is an addition program I wrote for my seven year old daughter, Amy. 
It presents the learner with a number line (lamentably a bit too small for 
the entire range of values generated) and with random pairs of numbers to 
add together. It gives a bit of positive feedback for correct answers and 
four opportunities to guess or calculate the right answer before giving up 
and presenting a brand new problem. At the end of the program the total 
number of right and wrong answers are presented and the student is encour- 
aged to run the program again. 


The numbers generated are all integers. With a bit of modification, the 
program can be made to generate negative integers or real numbers for more 
advanced students. 


Patrick Cunningham, San Antonio, TX 78216 (512)822-3593. 
EOF 
A> 


- POLY-VU 
#PVII9 


K&M Company 
TORRANCE, CA 90503 


er] 


oO 


-~CATALOGO45 
ABSTRACT045 


P/R 

P/RO000 
P/RO10 
P/R020 
P/R030 
P/R040 
P/RO50 
P/RO6A 
P/RO6B 
P/R070 
P/RO80 
P/R090 
P/R100 
P/R110 
P/R120 
P/R130 
P/R140 
P/R150 
P/R160 
P/R170 


More.. 
P/R180 
P/R190 
P/R200 
P/R210 
P/R220 
P/R230 
P/R240 
P/R250 
P/R260 
P/R270 
P/R280 
P/R290 
P/R291 
P/R300 
P/R310 
P/R320 
P/R321 
P/R330 
P/R3 40 


SUB 
BAS 
BAS 
BAS 
BAS 
BAS 
BAS 
BAS 
BAS 
BAS 
BAS 
BAS 
BAS 
BAS 
BAS 


41 file(s). 
23 directory entries remaining. 
D>STAT O: 


Bytes Remaining On O: 13k 


D> 


CPMUG vol. 


45 


2/11/50 


TYPE O:-CATALOG. 045 


VOLUME 45 
DESCRIPTION: Osborne/McGraw-Hill Payroll 
with Cost Accounting 
NUMBER SIZE NAME COMMENTS 
45.1 1K ~CATALOG.045 CONTENTS OF CP/M VOL. 45 
45.2 2K ABSTRACT.045 Abstract of CP/M Vol. 45 
45.3 1K P/R.SUB SUBMIT file for CBAS2 
compilation. 
45.4 2K P/R000.BAS Menu Program for P/R. 
45.5 5K P/R010.BAS Part of P/R. 
45.6 13K P/RO20.BAS Part of P/R. 
45.7 3K P/R030.BAS Part of P/R. 
45.8 2K P/RO40.BAS Part of P/R. 
45.9 10K P/R050.BAS Part of P/R. 
45.10 4k P/RO6A.BAS Part of P/R. 
45.11 8K P/RO6B.BAS Part of P/R. 
45.12 4k P/R0O70.BAS Part of P/R. 
45.13 2K P/RO80.BAS Part of P/R. 
45.14 8K P/RO90.BAS Part of P/R. 
45.15 9K P/R100.BAS Part of P/R. 
45.16 8K P/R110.BAS Part of P/R. 
45.17 3K P/R120.BAS Part of P/R. 
45.18 4k P/R130.BAS Part of P/R. 
45.19 6K P/R140.BAS Part of P/R. 
45.20 3K P/R150.BAS Part of P/R. 
45.21 2K P/R160.BAS Part of P/R. 
45.22 3K P/R170.BAS Part of P/R. 
45.23 8K P/R180.BAS Part of P/R. 
45.24 4K P/R190.BAS Part of P/R,. 
45.25 7K P/R200.BAS Part of P/R. 
45.26 9K P/R210.BAS Part of P/R. 
45.27 6K P/R220.BAS Part of P/R. 
45.28 5K P/R230.BAS Part of P/R. 
45.29 9K P/R240.BAS Part of P/R. 
45.30 3K P/R250.BAS Part of P/R. 
45.31 3K P/R260.BAS Part of P/R. 
45.32 ° 6K P/R270.BAS Part of P/R. 
45.33 15K P/R280.BAS Part of P/R. 
45.34 4k P/R290.BAS Part of P/R. 
45.35 10K P/R291.BAS Part of P/R. 
45.36 11K P/R300.BAS Part of P/R. 
45.37 5K P/R310.BAS Part of P/R. 
45.38 3K P/R320.BAS Part of P/R. 
45.39 7K P/R321.BAS Part of P/R. 
45.40 6K P/R330.BAS Part of P/R. 
45.41 3K P/R340.BAS Part of P/R. 


D> 


TYPE O:ABSTRACT.045 
ABSTRACT OF VOLUME 45 


Osborne/McGraw-Hill Payroll with Cost Accounting 


It is assumed that the user of this disk will also 
O::: obtained CP/M User Group volumes 43 and 44, 
sborne's Accounts-Payable/Accounts~Receivable and 
' General Ledger programs. This is important in this 
case aS we ran out of room on the disk (Oh, for a 
standard for double density!) and some of the subroutine 
-BAS files are on the other disks. I refer specifically 
to the following: 
CURSOR.BAS 
SUBS1.BAS 
GENINFO.BAS 


In addition it seems that our source (he who typed-in all 
these programs) missed some of the P/R subroutines which 
may be found in the book PAYROLL WITH COST ACCOUNTING 
published by Osborne/McGraw-Hill: 

PRNMASK.BAS 

FIND-EOF.BAS 

MSTRIN.BAS 

MSTROUT.BAS 

HISTORY.BAS 

P-RSEARC.BAS 

JOBFILE.BAS 


Also, one of the "main" programs is missing from this disk: 
MSTRINIT.BAS 


he above files are not overly lengthy and may be keyed in 
itout too much difficulty. It is assumed that the user will 
compile these programs and place the .INT files on a master 
workdisk, leaving the .BAS files elsewhere as they are not 
needed for actual operation. 


There is a file P/R.SUB on this disk for ease of compiling. 
It is assumed that the person installing these programs for 
usage will have some familiarity with CBASIC2 conventions. 


‘The CP/M Users' Group assumes no liability or responsibility 
for these programs or the results of using these programs. 


James K. Mills 
Special Interest Group for CP/M 
Chicago Area Computer Hobbyist Exchange 


D> 


POLY-vu 
#PVII9 


K&M Company 
TORRANCE.CA 90503 


fe) 


oO 


-CATALOG048 
ABSTRACT0 48 
BDS-C BOC 
BDSCIO H 
BUGS Cc 
BUGS COM 
HLIFE Cc 
HLIFE COM 
HSTONE C 
HSTONE COM 
LIFE Cc 
LIFE COM 
MM Cc 
MM COM 
OTHELLO C 
OTHELLO COM 
PPONG c 
PPONG COM 
PRESSUP C 
PRESSUP COM 
R2 MAP 
RALLY Cc 
More.. 
RALLY COM 
RALLY MAP 
STONE Cc 
STONE COM 
TABIFY C 
TABIFY COM 
TTT Cc 
TTT COM 
VOLUME 48DOC 
31 file(s). 


CPMUG vol. 48 


32 directory entries remaining. 


D> 


cate ance. “ttt tt a iat. eM 


2/11/86 


TYPE O:-CATALOG.048 


VOLUME 48 National CP/M Users Group 
(CP/M is a trademark of Digital Research, Inc) 
DESCRIPTION: The BDS C Sampler Disk 


November 29, 1980 
Compiled by Leor Zolman, BD Software 


- Manual for BDS-C to give you a "flavor" of the compiler 
- Good programming examples in C , 

- Interesting games to play 

- Good use of H19-H89 (Programs with <H> are H19-H89 only) 


Most files are included in .COM form to allow you to execute 
them without having BDS-C. Be careful of RALLY.COM as it needs 


to do hard-coded I/O to detect console OUT status. 


NUMBER SIZE NAME COMMENTS 
3K -CATALOG.048 CONTENTS OF CP/M VOL. 48 
6K ABSTRACT. 048 Abstracts of the programs 
48.1 17K BDS-C.DOC BDS-C users manual (*) 
48.2 7K BDSCIO.H The standard library used to 
compile the programs 
48.3 8K BUGS.C <H> makes things crawl 
48.4 11K BUGS.COM around on your screen 
48.5 9K HLIFE.C <H> H19/H89 version of 48.9 
48.6 8K HLIFE.COM <H> ® * ".10 
48.7 13K HSTONE.C <H> "Awari" game program - 
48.8 12K HSTONE.COM . B 
48.9 9K LIFE.C Good implementation of Conway's 
48.10 8K LIFE.COM LIFE algorithm 
48.11 5K MM.C Mastermind interesting guessing 
48.12 ‘7K MM.COM game. Try it and see 
48.13 11K OTHELLO.C Game program 
48.14 12K OTHELLO.COM ” 
48.15 7K PPONG.C <H> "Polish Pong" bounce the 
48.16 7K PPONG.COM ball off "/" and "\" 
48.17 8K PRESSUP.C Game program 
48.18 8k PRESSUP.COM = bi 
48.19 1K R2.MAP <H> map for rally game 
48.20 10K RALLY.C <H> road rally arcade game 
48.21 10K RALLY. COM <H> .COM of 48.20, but... 
Besessse= ---> Caution!! Hard-coded I/O req'd 
48.22 2K RALLY .MAP <H> another map for 48.21 
48.23 10K STONE.C "Awari" game with "very smart 
48.24 9K STONE.COM computer" opponent 
48.25 2K TABIFY.C Turn multiple spaces into 
48.26 6K TABIFY.COM Proper CP/M tabs 
48.27 7K TTT.C Tic-Tac-Toe that "exhaustively" 
48.28 6K TTT.COM tests for best move 
48.29 3K VOLUME48 .DOC Leor's own comments 


(*) The original was 22K, but "TABIFY" deleted 5K of spaces!! 


D> 


LaPE OS ABSTRACT.u<& 
National CP/M Users Group disk 48 abstracts. 


Leor Zolman's BDS-C is rapidly becoming one of the most popular 

non-BASIC high-level languages under CP/M, for both the 

hobbyist and the professional. A nice structured language at 

a reasonable cost, with good documentation, and good execution 
4 peed. ...AND totally integrated into CP/M. 


"C" itself it a highly structured language, implementing the 
"classic" requirements for structured programming: It can 
either directly or indirectly perform DO WHILE, REPEAT UNTIL, 
DO CASE, as well as a rich "FOR"-type capability. 


With a few exceptions, BDS-C implements "C" as covered in the 
Kernighan and Ritchie "The C Programming Language” book, which 
comes with BDS-C. I quote the Lifeboat Ad: 


Supports structures, unions, 2 dimensional 
arrays, pointers, recursion and overlays. 
Features optimized code generator, variable 
sized buffers for file I/O, and capability 
to produce ROMable code. Includes macro 
package to enable user to produce linkable 
modules with MAC. Floating point functions, 
full run-time package and machine code 
library sources provided. Linker, library 
manager, and textbook provided. Compiler 
lacks initializers, statics, floats, and longs. 


For the convenience of "experienced" C programmers, BDS-C 
allows, for example, "register specification" for a variable, 
eo while not implemented, is syntactically accepted. The 
ost obvious thing missing is a data type of "float", but a 
floating point subroutine package is included, and a modified 
"printf" to support it. 


Due to the more recent versions having very complete source 
code for run-time packages and the system libraries, many 
excellent programs have been "squeezed" off of the single 
density distribution disk. 


This volume, in part, represents a source for these very good 
source programs, while offering several interesting .COM files 
for those who do not have the BDS-C compiler. 


The Users Group solicits additional BDS-C programs, and hopes 
to regularly come out with disks containing BDS-C programs. 


The programs on the disk are primarily intelligent game pro- 
grams, with some H19/H89 programs which take advantage of this 
CRT's capabilities, such as graphics. A good utility, TABIFY, 
is also included. See Leor's own "VOLUME48.DOC" on the disk, 
for comments. 


Here's some additional comments about the programs on the disk: 


LIFE.COM: Nice implementation. Enjoyable code to read, 
s are most of the programs. An interesting touch when 
you decide the configuration is no longer interesting - 
F press your "del" key, and if you don't smile, you're made 
y of stone. 
xs 


MM.COM: So you want to play a simple game of letter guessing, 
eh? Try this one. But watch your ego: it can be deflated. 
MasterMind is a "simole" came, that makes vou think. The 


b) 


Ny 


Oi says: 


computer generates a ranaom wWOrqg consis ANG ve % ewes 


from A-F. You simply "guess" 4 letters at a time, and MM tells 
you how many are "hits" i.e. the right letter in the right 
spot, and how many are misses. Thus you deduce the missing 
pattern. The game goes a bit slow, however (at least at 2MHz). 
Why? MM is computing how many possible words exist based , 

on the clues it has given you. When this number reaches Mey 


"you should have it by now". 

It becomes a real challenge to see how few times you can keep 
that message from coming out, and is a "real thrill" to “beat 
it" - especially a couple times in a row. However, having it 
"know" YOU should "know", but you "missed" catching on for, say 
5 turns, makes you feel like a real dummy. I finally made a MM 
"worksheet" to try to be more efficient. It looks like: 


AB | AB | AB | AB 
cD | cD | cD I CD 
EF | EF | EF | EF 
Thus I guess: A B Cc D 
and hear: 0 hits, 2 misses. 


I cross off A in the first column, B in the second, etc. You 
can ONLY do this if there were 0 hits. Still you'll be amused. 


OTHELLO.COM: Have you the patience to beat this one? 


PPONG.COM: fun H19/H89 game. Deflect the bali with "/" and 
"\".  T was amazed how fast it was on a 9600 baud terminal! 


PRESSUP.COM: A challenging game, not quite as bad as Othello. 


Ovary: This sounds so interesting I almost bought an H19. If 


I had actually seen it in operation, I bet I might. Randy 
Suess ran it and said it was excellent, except that the screen 
flickered a bit due to lots of reverse video "...but I have an 
Older H19 and the new ones may be better". 


STONE.COM: You get to specify how "hard" the computer works to 
beat you, and if you let it work a while, it's nearly un- 
beatable. 


TABIFY.COM: A nice utility to delete spaces from a file, in- 
serting tabs where appropriate, based on the CP/M convention. 


TTT.COM: Hmmm, what could be new in a Tic Tac Toe game? Well, 
brains, and wit for two things. Ex: it puts its "X", you put 
your "o", it thinks a while, and says "I've got ya". If it 
thinks for a while, and after several pieces are on the board, 
doesn't say "I've got ya", then you MAY be on your way to a 
rare win, or more likely a "cat" game. Play it and see. 


VOLUME48.DOC: Leor's own comments. 


Abstracts by 
Ward Christensen 


@>>TYPE 0: VOLUME48. DOC 


uk 


N 


The BDS C Sampler Disk 


For the CPMUG November 


Compiled by Leor Zolman, BD Software 


This disk contains a collection of vnroarams written in RDS Co vist. 


and compiled forms, along witn a snort aocument aescrioding cne 344 - package 
for those who've never seen it. Some of the programs have been distributed 
with the BDS C package in the past, but currently there are so many assembler 
sources provided with the package that there isn't much room for games; thus, 
if you have purchased vl.4 or a later version of the compiler, many of these 
programs will be new to you. 


@ince H19 terminals and H89 computers are pretty popular among the company I 
keep, there are a lot of game programs here that require the H19 hardware. If 
you don't have either an H19 or access to one, non-H19 versions of some of 
the games are also provided for use on any kind of terminal. 


Here are descriptions of the programs on this disk: 


TABIFY.C: utility to turn sequences of spaces into tabs where possible 
PRESSUP.C: "Pressups" board game, uses alpha-beta searching 

STONE.C: "Awari"” board game (pits and stones); [HSTONE.C for H19/H89] 
LIFE.C: What can one say about this? [HLIFE.C for H19/H89] 

MM.C: Single-player mastermind, you guess and computer kibitzes. 
TTT.C: Invincible tic-tac-toe game. 

OTHELLO.C: The game of dramatic reversals. 

RALLY.C: Arcade game, for H19/H89 only. NOTE: this program uses the 


console serial port parameters defined in BDSCIO.H, and so 
will probably NOT run on your system until those parameters 

re) are customized and the program recompiled (this is necessary 
because the program must be able to poll the console OUTPUT, 
to see if it is ready to send, and there is no way to do this 
using CP/M bdos or bios calls...thus the bit numbers must be 
built right into the program...) 


BUGS.C: Make bizzare thingies crawl around on your H19/H89 screen. 
PPONG.C: Polish Pong for H19/H89 only. 
D> 
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* * 
s The BD Software C Compiler v1.41 10/9/80 - 
* * 
i written by: Leor Zolman * 
* BD Software * 
re) * 173 Hampshire st. #2 3 
* Cambridge, Mass. 02139 * 
* (617) 492-3038 evenings * 
* * 
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This flier represents most of the BDS C Bandbook that comes with each copy of 
the compiler (in addition to the User's Guide). The BDS C package is available 
only from: 


Lifeboat Associates Price: $145 on 8" CP/M disks; 
1651 Third Ave. Contact Lifeboat for the 
New York, NY 10028 prices on other formats. 


(212) 860-0300 


There is NO restriction on use of COM files generated by the BDS C Compiler; 
Users are free to place such items on the market without paying any royalty for 
use of run-time routines provided with the compiler package. 


The main components of the BDS C package are: four executable COM files 
(CCL.COM, CC2.COM, CLINK.COM and CLIB.COM), two standard library files 
(DEFF.CRL and DEFF2.CRL), and a =e run-time package module (C.CCC). For 
customization purposes, sources are provided for C.CCC (CCC.ASM) and all 
library functions written in assembler (DEFF2.ASM and DEFF2A.ASM). There are 


oo various sample source programs and utility packages. included. 


A description of each follows: 


CCl: The first phase of the compiler: accepts a C source file with any 
filename and extension (say, "foo.c") and produces a temporary file 
containing a symbol table and an encoded form of the source code. By 
default, CCl leaves the temporary file in ram and attempts to load in 
the next phase of the compiler (CC2) from the currently logged in 
disk (unless errors occur); see the"-a" option below for control 
details. 


The file extension".C" is NOT assumed for the source file name, so 
saying"foo" when you mean "foo.c" would not work. 


If the source file name is preceded by a disk designation, then the 
input is taken from the specified disk, and the output (if no errors) 
is written to that disk. 


Following the name of the source file on the command line, you may 
specify a list of options, each"optionally" preceded by a dash. 


The recognized options are: 


Cw) -O causes speed-optimization to be performed instead of 


space-optimization. I.e., causes the final generated code to 
be longer but faster. Will ONLY work if CC2 is auto-loaded 
by CCl. 


-p causes the result of the preprocessor phase of compilation 
(i.e., the result of #define and #include text substitutions) 
to be written to the CP/M console outvout, with lines numbers 


¢ 


CC2: 


Pr alee 


r 


generatea. I you -ype a Cun fyvars eeaeee PSS Oy) er cgce seg ee a Feet 
the command line, output will also go to the list device. 


~e xxxx Specifies an explicit, absolute address for the external data 
area, letting the compiler generate direct loads and stores 
(using"lhld" and "shid") for external variables. Will ONLY 


work if CC2 is auto-loaded by CCl. 


-m xxxx Specifies the starting address of C.CCC package at run-time. 
Normally (under CP/M) this defaults to the base of the TPA; 
use -m when generating code for a customized environment. See 
the"CRL Format" section of the User's Guide for details on 
customization. Will ONLY work if CC2 is auto-loaded by CCl. 


-ron Reserves nK bytes for the symbol table. Default value for n 
is 8 (6 for 4200h-based versions.) Minimum symbol table size 
is 5K. 

“a x Causes CC2.COM to be auto-loaded from disk x, where x may be 


ma", "b", "co", etc...or "Zz" to force a .CCI file to be 
written to disk (under control of the "-d" option below.) 


You'd use this option when the disk on which your BDS C 
commands reside is NOT the currently logged disk; In _ the 
absence of this option, CCl will auto- load CC2 from the 
currently logged disk. 


-d x Specifies to which disk the .CRL file output of the compiler 
is to be written. The default is the disk from which the 
source was taken. Again, x can be"a", "b", "c", etc. 


If auto-loading of CC2 is not performed (i.e., if the"-a z" 
option is used), then this option controls which disk the 
-CCI file output is to be written to. 


-c Disables the comment-nesting feature; When this is used, then 
the first"*/" after any "/*" is encountered closes’ the 
comment. If"-c" is NOT used, then each occurence of "/*" 
requires a matching "*/" before a comment is considered 


terminated. 


On a 2 MHz 8080, processing speed (not counting disk waiting) is 
about 15 lines of source/second. On a 4 MHz 280, speed is about 35 
lines/sec. 


This is the second phase of the compiler. CC2 accepts a".CCI" file 

as input, and writes out a".CRL" file if no errors are detected. 

(CRL is mnemonic for 'C ReLocatable'.) Normally CC2.COM is 

automatically loaded in (by CCl) and operates on the CCI file left in 

aoe by CCl; If invoked explicitly, then the .CCI file is loaded 
rom disk. 


If all goes well, writing out of the CRL file is followed by deletion 
of the"CCI" file (if it exits), and compilation is complete. 


On an 8080, execution speed = about 35 lines/sec. On a 4 MHz 280, 
speed is about 90 lines/sec. 


This program links a"main" function from a given CRL file in with 
C.CCC (for common system subroutines) and any subordinate functions 
which "main" may require (from perhaps many CRL files). Alternately, 
CLINK may be used to prepare a code segment which can be swapped in 
at run time by the root module. 


A successful linkage cauSsSe€S @ .-wr 214 0 28 genelu euria win ve 
point the 8080 absolute machine code file is ready to be executed 
(for better or worse) aS a transient command by CP/M (or swapped in 


by another COM file.) 


The first argument on the command line must be the name of a CRL file 
containing a"main" function; it may be preceded by a disk 
designation, to state where all .CRL files (except DEFF*.CRL) are to 
be searched for if further disk designators are omitted. 


Any other CRL files to search may also be specified on the command 
line (WITHOUT their".CRL" extensions), causing them to be searched 
in the order specified. The default disk to search will be the same 
disk from which the original CRL file was taken; this default can be 
overridden by specifying an explicit disk designation for any 
appropriate CRL file name needing it. For example, 


A>clink c:foo bar a:zot fraz 


causes Gisk C to be searched for the files FOO.CRL, BAR.CRL and 
FRAZ.CRL, and disk A to be searched to find ZOT.CRL. Note that C.CCC, 
DEFF.CRL and DEFF2.CRL are expected to reside on the currently-logged 
disk, unless the -c option is used (see below.) 


After all given CRL files have been searched once, CLINK will 
automatically search DEFF.CRL and then DEFF2.CRL. 


If there are still some unresolved references, then CLINK will ask 
for input from the keyboard to try resolving them. This situation is 
likely to arise in the case where a function becomes "needed" AFTER 
the CRL file containing it has already been searched. When yanking 
functions out of a CRL file, CLINK will only take those which are 
already known to be needed (due to a prior reference.) Thus, it will 
save you some pain to order the CRL filenames on the command line in 
such a way as to minimize undefined backward references. This ONLY 
applies to multiple CRL files; the order of functions within a single 
CRL file makes no difference. 


There are several options which may be specified on the CLINK command 
line. Each option must be preceded by a dash (~); the space between 
options and their argument (if needed) is optional. 


The presently supported options are: 
-s Prints out load statistics. 


-d ["args"] Use this to run the code immediately after linking, 
for debugging purposes, instead of writing a COM 
file out to disk. If a quoted string is given, 
then that string is treated as a list of command 
line arguments and is passed to the executing 
program as if via the CCP. 


-t nnnn Reserves location nnnn (hex) and above for user; 
default is to reserve no space. What this really 
does is to cause the first op in the object file to 
become 


lxi sp,;nnnn 
instead of the usual 


lhid BASE+6 
sphl 


(or) 
(or) 


-oO name 
-o name. 
-o name. 


~“@ XXXX 


“Cc xX 


-y name 


—W 


“Vv 


-1 xxxx 


“CY XXXX 


Causes the .COM file generated to 
be called"name.COM", "name" or 

ext"name.ext” respectively. If omitted, the name of 
the "main" .CRL file is used by default, with the 
extension".COM". 


The name may also have a disk designator to direct 
the output to any disk (in lieu of the special 
extension code on the"main" CRL filename). If a 
disk designator ALONE is given (e.g.,"-o b:") then 
the output is directed to the specified disk 
without affecting the filename. 


Sets start of data area to address xxxx, to 
maintain consistency between several separate .COM 
files when chaining (via the library function 

"exec") is used and external data need to be 
shared. If the program will be swapping in 
segments, then the value given MUST BE GREATER THAN 
THE HIGHEST ADDRESS THAT WILL EVER BE OCCUPIED BY 
SWAPPED-IN CODE. Note that the "Stack space" 
statistic, printed upon completion of linkage if 

"-s" is given, may be incorrect when this option is 
used. 


Tells CLINK to obtain the files C.CCC, DEFF.CRL and 
DEFF2.CRL from disk "x". By default, these files 
are assumed to reside on the currently logged disk. 


Yanks in the symbol table file"name.SYM" from 
disk, and defines all the symbols found therein. 
This is used when linking an overlay segment, to 
pre-define the function addresses resident in the 
root node and accessible by the segment. See the -w 
option below. 


Causes a SID-compatible symbol table file to be 
written to disk for use either by SID or by CLINK 
later on when linking overlay segments (see the -y 
option above.) 


Specifies that the resultant COM file is to be 
Swapped in as an overlay segment by another command 
at run time, so the run-time package (C.CCC) is not 
linked into the code. The"-1" (letter e11) option 
should always be used with"-v". Note that this 
option replaces the awkward"foo.aaS" scheme of 
previous versions. 


(letter ell) Sets the starting (load) address of 
the generated code. Normally, this defaults to the 
base of the TPA; If used with the"-v" option, this 
generates an overlay segment to load in at address 
Xxxx. If the"-v" option is not given, then the 
run-time package (C.CCC) must have been previously 
re-assembled to run at location xxxx (since the 
run-time package always resides at the base of the 
root segment.) For detailed info on generating code 
to run at an arbitrary starting address and/or to 
be ROMable, see the"CRL Format" section of the 
User's Guide. 


Reserve xxxx bytes (in HEX) for the internal CLINK 


forward function reference table. This table's not 
being hia enough (sand ms £93°) Ke aghe © igs (oe © Eee 


CLIB: 


overflow) were responsible for CLINK's previous 
tendency to crash on big linkages. While CLINK 
won't crash anymore, it may give you a"Ref table 
overflow" message and quit; if this happens, use 
this option with an argument larger than the 600h 
default for regular CP/M, or the 400h default for 
4200h-based CP/M systems, to enlarge the table 
area. Of course, this reduces the space available 
for linked code...if CLINK gives you an"Out of 
memory" message, use the "=r" option to reduce the 
reserved table space and provide more code space. 
Chances are, though, that you won't be able to 
reduce the table space by much before running out 
of it. Time for overlays... 


This program maintains .CRL files, allows transfer of functions from 
one CRL file to another, etc. To invoke CLIB, just type 


A>clib 
CLIB will print a line such as 
Function buffer size = nnnnn 


specifying the largest function size that can be handled. Attempting 
to"transfer” or “extract” a function larger than this size could be 
destructive. 


Next CLIB will prompt with a "*". Typing "h" at this point will give 
you a command summary. 


Basically, you work CLIB by opening one to six CRL files (which then 
become associated with"file numbers"), diddling the files to your 
hearts content, closing all files which you altered, and typing 
control1-C. 


The old version of any CRL file you change with CLIB is renamed to 
name.BRL (for Backup ReLative). 


A sample session of CLIB to, say, transfer the functions named"FOO", 
"BAR", and "ZOT" from a CRL file named "DSSR" on disk B: to one named 
"RTS" on disk A: would go as follows: 


A>clib 

BD Sofware C Librarian vl.4 
Function buffer size = xxxxx bytes 
* open 0 b:dssr 

open 1 rts 

t 0 1 foo 

t 01 bar 


+e te FF 


The"open" commands prepare to do work on a .CRL file, and associate 

each .CRL file opened with a digit (0-9). The"transfer" commands 

tell CLIB to transfer the named function from the first file (named 
by file #) to the second file (also named by number). The "close" 
command need only be given for files which have been altered; since 
DSSR wasn't written to in the above example, it didn't need to be 
closed, but RTS did need to be closed. 


DEFF.CRL: 


DEFF2.CRL: 


C.CCC: 


OTHER THIN 


STDLIB1.C 
STDLIB2.C 
OTHELLO.C 
RALLY .C 
PPONG.C 


~~ TELNET.C 


CONVERT.C 


CCOT.C 


FLOAT.DOC, 
FLOAT.C 


FLOATSUM.C 
CMAC.LIB, 
CCC.ASM 


oS" DEFF2.ASM 


DEFF2A.ASM 


BDS.LIB 


Contains all compiled functions from STDLIB1.C and STDLIB2.C. ; See 
the BDS C User's Guide, STDLIB1.C and STDLIB2.C for documentation on 
these functions. 


Contains all library functions coded in assembly language; the 
sources to all of these functions (except"fp") are in DEFF2.ASM and 
DEFF2A.ASM. 


The run-time package, containing code for processing the command line 
(generating argc and argv, for you Unix [1] lovers), room for file 
I/O buffers, some math subroutines, etc. This run-time package is 
always linked in at the beginning of root segment COM files generated 
by CLINK. The source to C.CCC is CCC.ASM. 


GS YOU GET WITH THE PACKAGE: 


Source for library functions which are written in C and 
present, in compiled form, within DEFF.CRL. 


More DEFF.CRL library function sources. 


Game program. ServeS aS a good example of modular coding, 
passing arrays as arguments to functions, and the "qsort" 
library function. 


Arcade game, for H19 terminal only (uses files RALLY.MAP and 
R2.MAP). 


Polish Pong, for the H19. Very interesting little hack. 


Program to let a system be used as a terminal, optionally 
routing stuff from modem to disk and vice- versa. Nice 
hanshaking and check- summing features. Hairy but useful. 


Converts unprintable characters (for systems having upper-case 
only and/or incomplete special symbol set) into special 


2-character sequences beginning with the character '#'. See 
also CCOT.C 


Converts C source files containing the special sequences 


generated by the CONVERT program back into a form that can be 
compiled. 


Bob Mathias's contributed floating 


point package (uses the"fp" function which resides in 
DEFF2.CRL.) 


Sample program using the floating point package. 


Macro package for use with Digital Research's"mac" macro 


assembler to create CRL files painlessly from assembly 
programs. 


Source to the C.CCC run-time package. 


Source to the machine-language library functions. Uses the 


CMAC.LIB macro package, requiring Digital Research's MAC for 
assembly. 


More of the above 


Global header file for FNS.ASM. 


POLY-vuU 
#PV119 


K&M Company 
TORRANCE, GA 90503 
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-CATALOG053 
ADVCOMP SUB 
ADVENT C 

ADVENT COM 
ADVENT CRL 
ADVENT 4H 

ADVENT1 DAT 
ADVENT2 DAT 
ADVENT3 DAT 
ADVENT4 DAT 
ADVENT5 DAT 
ADVENT6 DAT 
ADVLINK SUB 
CATALOG DOC 
CRCK COM 
CRCKLISTCRC 
DATABASEC 

DATABASECRL 
EADVENT C 

EADVENT COM 
EADVENT CRL 
ENGLISH C , 


More... 
ENGLISH CRL 
ENVIRON DOC 
ITVERB C 
ITVERB CRL 
MKADVENTSUB 
MKEADVENSUB 
MKSAVEADSUB 
READ ME 
SAVEADV C 
SAVEADV COM 
SAVEADV CRL 


TURN Cc 
TURN CRL 
VERB C 
VERB CRL 


37 file(s). 


CPMUG vol. 


24 directory entries remaining. 


D>STAT O: 


Bytes Remaining On O: 34k 


D> 


53 


2/11/86 


TYPE O:-CATALOG.053 


VOLUME 53 


DESCRIPTION: BDS-C Users group "original" Adventure disk. 
This is the "original" Crowther/Woods adventure, converted 
into BDS-C by Jay R. Jaeger, and updated for V 1.43 by L.C Calhoun. 
We thank Robert Ward, and the BDS-C Users group for this 
entire volume contribution. 


NUMBER SIZE 


53.1 1K 
53.2 5K 
53.3 10K 
53.4 5K 
53.5 6K 
53.6 18K 
53.7 7K 
53.8 7K 
53.9 4k 
53.10 6K 
53.11 18K 
53.12 1K 
53.13 2K 
53.14 7K 
53.15 5K 
53.16 1K 
53.17 24K 
53.18 1K 
53.19 3K 
53.20 2K 
53.21 3K 
53.22 4K 
53.23 3K 
53.24 1K 
53.25 1K 
53.26 1K 
53.27 1K 
53.28 1K 
53.29 7K 
53.30 2K 
53.31 14k 
53.32 10K 
53.33 13K 
53.34 8K 


NAME 


-CATALOG.053 
ADVCOMP.SUB 
ADVENT.C 
ADVENT.COM 
ADVENT.CRL 
ADVENT.H 
ADVENT1 .DAT 
ADVENT2.DAT 
ADVENT3 .DAT 
ADVENT4.DAT 
ADVENTS5.DAT 
ADVENT6 .DAT 
ADVLINK.SUB 
CATALOG .DOC 
DATABASE .C 
DATABASE.CRL 
EADVENT.C 
EADVENT.COM 
EADVENT.CRL 
ENGLISH.C 
ENGLISH.CRL 
ENVIRON. DOC 
ITVERB.C 
ITVERB.CRL 
MKADVENT. SUB 
MKEADVEN. SUB 
MKSAVEAD. SUB 
READ .ME 
SAVEADV.C 
SAVEADV. COM 
SAVEADV.CRL 
TURN.C 
TURN.CRL 
VERB.C 
VERB.CRL 


CRCK.COM 
CRCKLIST.CRC 


COMMENTS 


CONTENTS OF CP/M VOL. 053 
These files are 
fully explained 
in "CATALOG.DOC", 
and appear here 
merely to get 
"official numbers". 


Program to check CRC of each file. 
List of CRC's for all files. 


If you suspect your copy of this disk is bad, run CRCK *.* 


and compare the CRC's against the ones in CRCLIST.CRC. 


If you want 


to create a new file, use CRCK *.* F but be aware it will overwrite 
CRCKLIST.CRC which should probably have been renamed to something else. 


D> 


TYPE O:CATALOG. DOC 
CATALOG .DOC 


Filename.ext Size Description 
CATALOG .DOC Catalog of files added/changed on disk 
ADVCOMP. SUB 1K Submit file for compilations of ADVENTURE programs 
ADVENT.C 5K Main Adventure Program, in C 
@>ovent.com 10K Compiled and linked version call up by ADVENT 
ADVENT. CRL 5K 
ADVENT.H 6K Only significant change, to V 1.43 disk buffering 
this is header file for ADVENTURE DO NOT USE 
BDSCIO.H ! 
ADVENTI1.DAT 18K Furnished adventure data file, no change 
ADVENT2.DAT 7K ditto 
ADVENT3.DAT 7K ditto 
ADVENT4.DAT 4K ditto 
ADVENTS5.DAT 6k ditto 
ADVENT6.DAT 18K ditto, don't forget you need these to run 
ADVLINK.SUB 1K Submit file for linking up three ADVENTURE chains to 
get .COM files 
DATABASE.C 7K Source for data manipulation subprograms 
DATABASE.CRL 5K 
EADVENT.C 1K Source for main operating link of ADVENTURE 
EADVENT.CRL 1K 


EADVENT.COM 24K COM file, called in by EXEC from ADVENT. By the way, 


it works OK when in the b: disk with V 1.43? 


ENGLISH.C 3K Another Source 
ENGLISH.CRL 2K 
ENVIRON. DOC 3K Description of original environment, plus notes added 
when running under 1.43 
ITVERB.C 4K Another Source 
ITVERB.CRL 3K 
KADVENT.SUB 1K These three are original link subs - won't work under 
; KEADVEN.SUB 1K under V 1.43, see ADVLINK.SUB instead. 
MKSAVEAD.SUB 1K 
READ .ME General notes on the revision and revisor 
SAVEADV.C 1K Source of link used to save a game 
SAVEADV.COM 7K 
SAVEADV.CRL 2K 
TURN.C 14K Another source of sub-programs 
TURN.CRL 10K 
VERB.C 13K Another source 
VERB.CRL 8K 


D>TYPE O:READ.ME 
NOTES ABOUT MODIFICATION TO PROGRAMS 
These modifications (trivial) and compilation/checkout 

were done by: L. C. Calhoun PE 

257 South Broadway 

Lebanon, Ohio 45036 <513> 932-4541/433-7510 
The only change required was in ADVENT.H, to adjust the buffer 
call outs to fit the standard BDS-C Version 1.43 utilities. 
Compilation and Linking calls were changed to accomodate 
the V 1.43 changes. More notes will be found in ENVIRON.DOC. 
The game was brought up, and played for a few minutes to ensure 
that it was no worse than before. I didn't have time to do 
any checks on the game's performance as a game--but then I wasn't 
asked to. It behaved, for that short time, as did the original 
DVENT.COM on the disk from the BDSCUG. 
The old COM files have been deleted, and the .C files replaced. 
CRL, a new pair of submit files, and documentation files have been 
added. 


% 


D> 


ii-fw US ENVIRON.DOC 
Notes on Adventure Environment 
written April 26, 1981 


This disk was written and and compiled under version 1.3x and 
will NOT compile under version 1.4 and later without changes to the 
source. Specifically dbuff in advent.h on or about line 134 must be 

eclared so that it is compatible with the 1.4 file i/o. The com files 
on the disk will require at least a 46k system to execute, but 
recompiling under 1.4 will add about 1k to the memory requirements 
(except that 1.4 produces tighter code). 

The com files provided were debugged on a system including 
a 48k Altair equipped with 2 Micropolis drives, and a Processor 
Technology VDM. 

To begin play, type advent. To resume a saved game type 
"advent -r". 


Added notes on making this ADVENTURE work in BDS-C Version 1.43 
Environment written 17 May 1981 by L. C. Calhoun. 


At Robert Ward's request, I brought this program up on 
the 1.43 compiler. Only one change was required..to add the 
small section on buffering from BDSCIO.H to ADVENT.H, and to 
change dbuff£[134] in ADVENT.H to dbuff[BUFSIZ]. I did review 
the other program files for potential changes, and added a 
title and note to the head of each for the record. The compile 
and link control syntaxes differ between V 1.4 and older versions. 
I made the appropriate changes, and created two submit files; 
ADVCOMP.SUB and ADVLINK.SUB. These must (of course) run on 
disk a:, but they are set up for all the c utilities to be on 
disk a: and the actual c programs with their .CRL files to be 
on b:. Just PIP these two sub files over to the a: disk where 

C1, CC2, C.CCC, CLINK, DEFF* etc. hang out. Only one file 
Wneeds to be read two times during linkage - TURN.CRL while 

EADVENT.COM is being linked. Otherwise, it went smoothly 

in conversion. 


Mr. Jaeger (me too, I must admit) was worried that 
the greater buffer size used in the standard V 1.43 library 
would have a bad effect on the program length. I compiled 
without the -o option for optimization. Lo and behold, 
the program appears to be considerably shorter. I was able 
to external set the data (-e6A00) much lower than in the 
submit files supplied. I could have even gone lower. 

I compiled a second time with the e option in CCl to -e6A00, 
see ADVCOMP.SUB. Dog gone if the code didn't end at 5EC8. 
However, the variables end at 7CAl even with the -e6A00, 

so I didn't bother. 


The re-compiles were done on an ALTAIR 8800B, with 
a 60K CPM 2.2 system, ADM-3A display, and TARBEL single side 
single density controlling four Shugart 801R's. I checked 
the elboeroom callouts during compile, and the least amount 
of elboeroom was 20K whilst compiling TURN.C. So, it appears 
that the re-compiled version will compile and run on 
a 40K system with about 4K of stack space. You can pick 
up another 2K of stack space by editing the ADVCOMP.SUB file 
for the option -e6000 if it's worthwhile. Thank you Mr. Zolman. 


D> 
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-CATALOGOSA4 5K 
| 1CHECK BAS 3K 
ABSTRACT054 21K 
ALFABET2BAS 2K 
ALFABETIBAS 1K 
ARITH BAS 2K 
Oo BIOCAL BAS 4K 
BLKJAC BAS 8K 
BOMBER BAS 3K 
BOUNCE BAS 2K 
BUG BAS 7K 
BULCOW BAS 2K 
BUNNY BAS 7K 
BUZZWD BAS 3K 
CHASE BAS 4k 
CHASE2 BAS 6K 
CHOMP BAS 3K 
CRAPS BAS 3K 
CRCK COM 2K 
CRCKLISTCRC 3K 
CUBE BAS 5K 
DEFUSE BAS 3K 
2a 
ES More.. 
aa DIAMND BAS 1K 
a* DRAW BAS 3K 
DRINKS BAS 2K 
FISHING BAS 3K 
FOOTBL BAS 9K 
FRACT BAS 2K 
GRAFIT BAS 1K 
GUNNER BAS 2K 
Ce) HOCKEY BAS 6K 
HORSES BAS 4K 
INTERESTBAS 1K 
KING BAS 10K 
LITQZ BAS 2K 
MATH BAS 2K 
MUGWMP BAS 2K 
PICTUR BAS 3K 
POET BAS 2K 
POKER BAS 8K 
> PRIME BAS 1K 
5 QUBIC BAS 7K 
Qo Z REVRSE BAS 3K 
ES ROCKET BAS 4K 
Q oO 
s : More.. 
B ROCKT1 BAS 3K 
x 2 SNOOPY BAS 4K 
SPORTS BAS 3K 
STARS BAS 2K 
STOCK BAS 8K 
TAKEAWAYBAS 2K 
TDRILL BAS 5K 
TENNIS BAS 4K 
TEXT BAS 2K 
TICTAC BAS 5K 3 directory entries remaining. 
Oo TRAP BAS 2K D>STAT O: 
TTTOE BAS 3K 
: TVPLOT BAS 3K Bytes Remaining On O: 10k 
meek, TYPING BAS 1K 
WEKDAY BAS 4K D> 
WISHES BAS 3K ee ages Pte a ee ee ee eR 


60 file(s). 
oe aj mtn re 


“LF sETUALA WVU. JIS 
VOLUME 54 
DESCRIPTION: Xitan Disk Basic: 
1. Games 
2. CAI programs 


were contributed to the CPMUG 
The files were reviewed and 


any of the games found here 
by William P. Ruf of Kansas. 
abstracted by Jim Kennedy of CACHE (the Chicago Area Computer 
Hobbyist Exchange), who also made some corrections to some 
programs, or, in some cases, pointed out the known bugs in 
some of these programs for users to de-bug. Jim also 
contributed his own "typing drill" program, TDRILL.BAS. 

These programs are written (or modified) for Xitan Disk 
Basic, but some will run under MBASIC without modification, 
and some require only slight modification. 


I regret that not all of these programs run correctly as 
provided, but the ones that do not are marked in the catalog 
below, or the abstract, or both. Some draw pictures on your 
screen and the TDL video board may be required for those 
programs. It is not normally the policy of the CP/M UG to 
release buggy programs, but I felt that, in this case, 

if the programs were released, some of our users might 
de-bug and re-submit these programs for future volumes. 


Jim Mills, CPMUG reviewer 
NUMBER’ SIZE NAME COMMENTS 
-CATALOG.054 CONTENTS OF CP/M VOL. 54. 
Oo ABSTRACT.054 Abstracts of programs. 
N CRCK.COM CRC filecheck program. 
CRCKLIST.054 List of CRC's of files. 
54.1 3K 1CHECK.BAS Solitaire checker puzzle. 
54.2 2K ALFABET2.BAS Interactive alphabetizing, 
de-bugged and expanded. 
54.3 1K ALFABETI.BAS Original bugged version. 
54.4 2K ARITH.BAS Simple addition and subtraction for 
elementary students. 
54.5 4k BIOCAL.BAS Biorythmic calendar (Bugs). 
54.6 8K BLKJAC.BAS Blackjack (21) game. 
54.7 3K BOMBER. BAS WW2 Bomber game. 
54.8 2K BOUNCE. BAS Plots a bouncing ball. 
54.9 7K BUG.BAS "Draw Bugs faster than your 
computer" game. 
54.10 2K BULCOW.BAS Buggy program, number guessing game. 
54.11 7K BUNNY.BAS °. Draws a "bunny" on your CRT. 
54.12 3K BUZZWD.BAS Selects a list of "buzzwords". 
54.13 4K CHASE.BAS High Voltage survival game. 
54.14 6K « CHASE2.BAS Not related to above game. 
Construct and maneuver in a maze. 
54.15 3K CHOMP.BAS Eat pieces of a cookie, 
last piece loses (NIM?). 
54.16 3K CRAPS.BAS : Standard Nevada table rules. 
54.17 5K CUBE.BAS Get thru the cube & win a bet. 
K 54.18 3K DEFUSE.BAS Find and defuse the bomb before... 
™ 54.19 1K DIAMND.BAS Fills screen with diamond shapes 
that spell DEC. 
( 54.20 3K DRAW.BAS Buggy program -- see abstract. 
54.21 2K DRINKS.BAS "How to mix drinks", see abstract. 
S{ 54.22 3K FISHING. BAS Catch fish in a lake, avoid hazards, 
a mini-adventure game. 
54.23 9K FOOTBL.BAS Standard orofessional ry ofc 


except no penalties. 


54.24 2K FRACT.BAS Fraction mathematics. 
54.25 1K GRAFIT.BAS Some kind of student plotting program. 
54.26 2K GUNNER. BAS Fire a field artillery weapon, bugs. 
54.27 6K HOCKEY.BAS For hockey fans. 
54.28 4k HORSES.BAS Place your bets on the horse races. 
54.29 1K INTEREST.BAS Calculates simple and compund interest. 
GO 4.30 10K KING.BAS Land & Resources Management game. 
54.31 2K LITQZ.BAS CAI: Literature quiz. 
54.32 2K MATH.BAS See abstract for bugs. 
54.33 2K MUGWMP.BAS Triangulation game. 
54.34 3K PICTUR.BAS Draws your name and picture??? 
54.35 2K POET.BAS Random verse ala Edgar Allen Poe. 
54.36 8K POKER.BAS Draw Poker. 
54,37 1K PRIME.BAS Calculates prime numbers from 1 to 
10,000 -- patience is advised. 
54.38 5K deleted deleted by reviewer, who was too 
lazy to re-type the entire catalog. 
54.39 7K QUBIC.BAS 3D Tic Tac Toe in a 4x4x4 cube, bugs. 
54.40 3K REVRSE.BAS Arrange a list of numbers via reversals. 
54.41 4K ROCKET.BAS Lunar Lander. 
54.42 3K ROCKT1.BAS Lunar Lander. 
54.43 4K SNOOPY.BAS Draws a "Snoopy" on your CRT or printer. 
54.44 3K SPORTS.BAS CAI: Multiple choice questions 
about sports. 
54.45 2K STARS.BAS Number guessing game. 
54.46 8K STOCK.BAS Stock Market Simulation Game. 
54.47 2K TAKEAWAY .BAS Remove asterisks from a collection, 
similar to "CHOMP". 
54.48 5K TDRILL.BAS Typing drill program. 
54.49 4K TENNIS.BAS CAI: Multiple choice questions about... 
54.50 2K TEXT.BAS Intro to some programs on this disk. 
4.51 5K TICTAC.BAS 9x9 grid tic tac toe. 
4.52 2K TRAP.BAS "Guess the mystery number” 
54.53 3K TTTOE.BAS Standard tic tac toe with bugs. 
54.54 3K TVPLOT. BAS Humorous TV plots. 
54.55 1K TYPING.BAS Typing drill with bugs. 
54.56 4K WEKDAY.BAS Day of week that you were born. 
54.57 3K WISHES.BAS Silly wish poems for kids. 
D> 
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ABSTRACTS of CP/M USERS GROUP VOLUME 54 


This volume contains programs intended to be used with TDL-XITAN DISK BASIC. 
Many of these programs are modified versions of public domain programs which 
have been distributed by DECUS, the DIGITAL EQUIPMENT COMPUTER USERS SOCIETY. 
DECUS requires programs submitted to it for distribution be in the public 
omain. Many of these programs were originally written by high school 
Students and other individuals who wrote them and submitted them to a users 
group so that they could be shared with others. Back in 1971, a gentleman who 
worked for DIGITAL, helped in a project to collect donated programs, and 
publish them in a book called 101 BASIC COMPUTER GAMES. His name is David H. 
Ahl. Mr. Ahl left DEC in 1974, and asked for the rights to print the book 
independently. They agreed as long as the name was changed. He revised many 
of the programs, added some, removed some, and published a book he called 
BASIC COMPUTER GAMES, MICROCOMPUTER EDITION. He copyrighted the book. 
Meanwhile, DEC gave the original programs to DECUS, who distributed them on 
DECtape and Magtape to the computer community, essentially putting them in the 
public domain. It is this group of programs, (and NOT the revisions 
copyrighted by Creative Computing) that have been translated into TDL-XITAN 
BASIC and submitted to the CP/M user's group for this set of disks. Many of 
these programs were received by the CP/M users group in XITAN internal code. 
They have been translated back into ASCII for distribution, so it is possible 
that some of them will work on other BASICS, such as Microsoft BASIC. However, 
they have been checked out only with TDL-XITAN Disk BASIC for these abstracts. 
Some of these programs do have bugs, some of which are noted in these 
abstracts. The bugged programs are included so that some CP/M users who like 
challenges will have the opportunity to try their skills on finding and 
correcting these bugs. 


Jim Kennedy 


1CHECK.BAS 

Osciitaire checker puzzle by David Ahl. (written while he 
worked for DEC.) P. 163-164 of 101 BASIC Computer Games 
(published by Digital Equipment Corporation). Works 
fine, but it would be nice if the number grid were 
repeated at each move (for beginners who have not 
memorized position numbers). 


ALFABETI.BAS 

Author unknown. A nice little interactive 
alphabetizing program, which works OK on the 
first run, but then hangs up with 

a Re-Dimensioned array @ line 70 error 

when you try to enter a second list of items. 
SEE ALFABET2.BAS. 


ALFABET2.BAS 

This is the ALFABETI.BAS program revised by 

Jim Kennedy, to correct problems in the original, 
and give the user more detailed instructions. 
The program interactively accepts a list of 

words, names, etc., and prints an alphabetized 
list. Note: use all caps or all small 
letters in your items. Otherwise, items 

in caps will be listed before lower-case 

items in the alphabetized list. This program 
ould be modified to accept input from a file, 
rather than from the keyboard, but as it is, 
it serves as a good quick demonstration of 

yi a use of a computer. 


ARITH.BAS 
Presents simple addition problems. You give 
te anewer it tells vou if vou are rioht or 


wrong. If wrong, you get to try a second time. 

If still wrong, you are given the answer 

and then given a new problem. Good for 

elementary students for drill and practice in 
addition, and for more advanced students as 

an illustration of some CAI programming techniques. 


IOCAL.BAS 
Biorhythmic calendar. Will NOT run on my 
XITAN BASIC. % after numbers is OK on some 
Microsoft and Digital BASICs, but not 

on XITAN. Also, I think there should be 
more code after line 1430. Perhaps someone can 
find the source of this program and fix it up. 


BLKJAC.BAS 

P. 39-41 of 101 BASIC Computer Games. 

This version of Blackjack is the one written 
and modified by DIGITAL personnel, originally 
for RSTS-1l1. It runs well on XITAN DISK BASIC. 
It is very comprehensive and fun to play. (It 
takes a long time to load as an ASCII file.) 


BOMBER.BAS 

P. 45-46 in 101 BASIC Computer Games. 
Originally written by David Sherman of 
Curtis Junior High School, Sudbury, MA., and 
later modified by DIGITAL personnel. It has 
been since additionally modified to run on 
XITAN BASIC. In this program, you fly a 
world war II bomber for one of the 


countries involved in the war. You can 


ake some decisions, but your fate is 
argely up to the random number generator. 
It runs well, and was exciting for the 
children in the family for the first 

few times they ran it (until they ran 

out of options). 


BOUNCE. BAS 

This program plots a bouncing ball. Written by 

Val Skalabrin, and found on P. 47 of 101 BASIC 
Computer Games. The program takes a long time to 
print out if you choose figures requiring a tall 
plot. Try .1 sec, 25 FPS velocity and a coeficient 
of .9 to start. These figures will keep the plot 
on a 25 line TDL-VDB screen. : 


BUG.BAS 

P. 52-54 of 101 BASIC Computer Games. The object 
of this game is to finish your drawing of a bug 
before the computer finishes its drawing. Written 
in the early 70s by a 7th grade student, Brian 
Leibowitz. The computer rolls the dice each turn 
and the operator needs only to type yes (or return) 
or no to the question concerning the bug pictures. 


BULCOW.BAS 

- 55-56 of 101 BASIC Computer Games. 
This program does NOT work properly in 
XITAN BASIC. Running a TRACE on its 
execution shows it to get stuck ina 
loop between lines 210 and 220, possibly 
due to the FORI=0TOP-1, with the value 
of P starting at 0, with no STEP-1 
to tell it to count down. I1'11 leave 


41S fix up to someone else and press 
on with trying the other programs in 
this group. 


BUNNY.BAS 
By Goodyear Atomic Co., Piketon, Ohio. 
Submitted to DECUS 30 July 1973. 
his program sends a picture of 
a bunny head to the printer. It 
has obviously been re-written for 
XITAN DISK BASIC, and it works 
well. 


BUZZWD.BAS 

P. 63-64 of 101 BASIC Computer Games. 
Written by Tom Kloos of the Oregon 

Museum of Science and Industry. It 
prepares sets of "buzzwords" by selecting 
words from 3 lists and putting them 
together. Runs OK. 


CHASE.BAS 

"You are within the walls of a high 
voltage maze~--your only chance for 
survival is to manuver each intercepter 
into a high voltage area.” Eric, my 

9 year old game program tester, never 
seems to tire of this one. 


CHASE2.BAS 
This is a chase program written by 
Michael P. Ruf on 12/16/78. It asks 
os player for the width, the length, 
and the density of a maze. It then tries 
to construct a maze (which comes out 
on my screen as a column of symbols), 
and then asks for players' moves--- 
to be entered as numbers. Try this 
program on your system...it may work 
with your terminal configuration. 


CHOMP .BAS 

P, 78-79 of 101 BASIC Computer Games. Submitted 
to DIGITAL by Peter Sessions of Peoples Computer 
Company, based on the game of CHOMP (Scientific 
American, Jan. 1973). Players take turns 
chomping pieces from a 9X9 grid (the cookie). 
The player who has to take the last bite 

loses the game. Runs fine. 


CRAPS.BAS 

P. 83-84 of 101 BASIC Computer Games. Modified 
to work on XITAN BASIC. Original author 
unknown. This version is based on the standard 
Nevada craps table rules. Fun to play. 


CUBE.BAS 
P. 85-86 of 101 BASIC Computer Games. 
ritten by Jerimac Ratliff of Ft. Worth, 

Texas, and converted to RSTS/E by 

(A David Ahl. You progress along a cube 

Y from coordinate 1,1,1 to 3,3,3. 
You may be zapped by a land mine along 

% the way, but if you make it you win 
a wager you made when you started and are 
richer. You have a chance of guittine 


ana ;eeping your winnings, Or wagering 
all or part of your money on your next 
trip. This game is good for teaching 
the meaning of a 3 dimension coordinate 
system to youngsters. 


DRAW. BAS 

@ can'r Loap THIS ONE WITH XITAN 
BASIC. I GET A "MISSING STATEMENT 
NUMBER ERROR. 


DEFUSE.BAS 

Written by Tom Karzes, Curtis Jr. High 
School, Sudbury MA. and modified 

by Dave Ahl, DIGITAL. (NOT in 101 

BASIC Computer Games). You are in a 
large building, 100 rooms long, 100 rooms 
wide, and 100 rooms high and are looking 
for a bomb. You have a bomb strength 
meter to guide you to the bomb before 

it goes off. Everytime I played the game 
I got blown up. 


DIAMOND.BAS 

P. 87-88 of 101 BASIC Computer Games. Fills 
the screen (or an 8 1/2 X 11 piece of paper if 
you change some print statements to PRINT#2,) 
with diamond shapes each containing the letters 
DEC!!! You can control the size of the diamond 
shapes. This sort of program could easily be 
modified to produce other patterns. 


RINKS.BAS 

"This program prepares drink recipies 
guaranteed to make your next party a 'smashing' 
success." The program runs as is, and would be fun 
to show off at a party---but don't let anybody 
take it seriously. Some coding mistakes seem 
to have been made which do not prevent the 
running of the program. The coding on lines 
430 to 530 does not seem to even be used, and 
the SLEEP on line 430 would cause an error in 
XITAN BASIC if it were ever reached. 


FISHING.BAS 
You are at a dock at the north west corner of 
a square 8X8 unit lake. You are to move your 
boat through the lake and return to the dock 
with your catch by responding to the move question 
with a compass direction - N,S,E,W, or F for 
staying in a Fixed position. If you type B, 
the game will begin again. You must return to 
the dock within 6 (computer) hours or half your 
catch will spoil. If you hit the shore of the 
lake, you will be grounded and sunk. There 
are other hazzards to make the game exciting. 
(I corrected the copy received by the users 
group so that it would run on my system. I 
G@150 added detailed instructions.) J.K. 


FOOTBL.BAS 

P. 101-103 in 101 BASIC Computer Games. 
This simulation of the game of football 
a uses standard professional rules except 

that there are no penalties. This game 

-e foun to vlav once vou have memorized 


~3e numvers representing the different 
Plays. I suggest you ask for instructions 
the lst time you play and copy them on a 
piece of paper so you can refer to them 
during the game. 


FRACT.BAS 

uthor: Michael Ruf 
Written August 29, 1979 

This seems to be a well written program 
dealing with fraction math. However, 
it uses a WAIT statement that causes my 
system to hang up. It may 

work with a serial terminal accessing 
the correct port(s), or perhaps 

someone familiar with the WAIT command 
could modify it for his system. 


GRAFIT.BAS 
It runs, but I don't know its use--- 
Any ideas? 


GUNNER.BAS 
Written by Tom Kloss of the Oregon 
Museum of Science and Industry, and 
modified by David Ahl, DIGITAL. "This 
computer demonstration simulates the 
results of firing a field artillery 
weapon.” You give the degrees of 
elevation for each of 5 shots and are 
told how far you overshot or undershot 
the target. The game works as a game, 
on: the formula must be wrong for 
computing the trajectory, because some 
results are not realistic. Also, one 
time I was told the max range of the 
gun was 46500 yards and the distance 
to the target was 12178745 yards. 


HOCKEY.BAS 

P. 130-132 in 101 BASIC Computer Games. 
Written by Charles Buttrey of Eaglebrook 
School, Deerfield, MA. and submitted to 
DIGITAL by Mrs. Kingsley Norris. 
Converted from Brand X to DIGITAL RSTS/E 
by David Ahl. Instructions are easier 
than those of the football game, but the 
Play does not seem as interesting--- 
unless you are a real hockey fan--- 


HORSES.BAS 

P. 133-134 of 101 BASIC Computer Games. 
Author unknown - From DIGITAL. You 

are given the odds for each horse and 

you place your bets for win, place 

or show. After the race had been 

run, you are told your winnings (or losses) 
and invited to press your luck further. 


INTEREST. BAS 
, A simple program to calculate simple 
and compound interest over a 10 year 
¥, period. Works fine. Author unknown. 


KING.BAS 
P. 138-140 of 101 BASIC Comnuter Games. 


eutior: James A. Storer, Lexington H1ig_: SC 100 , 

modified by Dave Ahl, DEC. Available from 

DECUS, where it is called "Polution Game". 

One of the more comprehensive, difficult 

and interesting land and resource management 
games. It runs fine on XITAN BASIC and 

is a lot of fun to play. This copy often 
erminates play after 1 year, but that is 
probably because I am not a very good 

King. (Or the program could have a smal] bug). 


LITQZ.BAS 

P. 150 in 101 BASIC Computer Games. 

A simple CAI type program which presents four 
multiple choice questions from children's 
literature ---illustrates simple 

CAI techniques in BASIC. Questions could be changed 
and program expanded for other instructional 
objectives. 


MATH.BAS 

Author not known. Program won't run on my XITAN 
system with its TDL VDB board. The WAIT at line 504 
hangs it up. Perhaps the program would work 

with a system having a serial terminal using 

ports 72 and 73. 


MUGWMP.BAS 

P. 156-157 in 101 BASIC Computer Games. 

Originally written by the students of 

Bud Valente of Project SOLO at the 

University of Pittsburg, this program was 
lightly modified by Bob Albrecht of People's 
omputer Company and converted to DEC's RSTS/E 

by David Ahl when he worked for Digital. The 

object of the game is to locate four 

mugwmps hiding on various squares of a 

10 x 10 grid. Good practice in triangulation 
techniques. 


PICTUR.BAS 

Not in 101 BASIC Computer Games, but I 
have seen it in the DECUS library. 

It asks for your name and where you want 
your picture. You can have it displayed 
on the terminal by typing KB: or on the 
printer by typing LP: The program shows 

a technique for switching output from the 
video screen to the printer without having 
to re-write or edit your print statements. 


POET.BAS 

P. 171 of 101 BASIC Computer Games. 
Original author unknown. Modified and 
reworked by Jim Bailey, Peggy Ewing, and 
Dave Ahl of DIGITAL. This program 
produces random verse made of phrases 
suggestive of Edgar Allen Poe. It keeps 
oing until you hit control E (control C 
on some BASICS). 


& POKER. BAS 
¢) . 172-174 in 101 BASIC Computer Games. 
Vo Written by A. Christopher Hall, 
submitted to DECUS by A. E. Sapega. 
You play draw poker with the computer as 


your opponent. This game is a lot of fun 
to play, and if you lose, the computer 
forgets your debts when you say BYE. 


PRIME.BAS 

"This program prints the prime 

numbers from 1 to 10,000" (if 
ou can wait that long). Runs 

well, but takes a long time to 
compute each line of output. 


QUBIC.BAS 

P. 175-177 

Original author unknown...Was on a GE 
timesharing system in 1968. 

Now in DECUS library. Qubic is the game 

of tic-tac-toe in a 4X4X4 cube. Considerably 
more difficult than standard two dimensional 
tic-tac-toe.. This version has been improved 
over the one in 101 BASIC Computer Games by 
the addition of a provision to display the 
board on command. Be patient--the computer 
sometimes takes many seconds to determine 

its move. The program does have a bug. 

I received a NEXT WITHOUT FOR @ LINE 206 
error several times after more than a dozen 
moves. I11 leave the de-bugging to one of 
you users out there. If you find the 

bug, submit a corrected program and the 

users group will thank you. 


REVRSE.BAS 

P. 180-181 in 101 BASIC Computer Games. 
Oirzitten by Bob Albrecht, People's Computer Co. 

The game requires you to arrange a list of 

numbers in numerical order from left to 

right by reversing numbers. 


ROCKET.BAS 

P. 184 of 101 BASIC Computer Games. 
Written by Jim Storer, Lexington H.S. 
Converted from Focal to EDUSYSTEM 30 
BASIC by David Ahl, DIGITAL. This version 
has been considerably further modified to 
work with XITAN BASIC. Fun to play, but 
the lb. fuel remaining indicator seems 

to be set too high, causing you 

to run out of fuel and crash when you 
think you have enough fuel to make it. 


ROCKT1.BAS 

P. 185 in 101 BASIC Computer Games. 

Written by Eric Peters of DIGITAL. 

One of many variations of the lunar lander idea. 
This one plots a graph of your descent. 


SNOOPY.BAS 
This "SNOOPY" allows you to enter your 
ame, and determine if you want the 

output on the line printer or the video 

display. It then prints the Snoopy and 
yy puts your name under it. If done on the 
yh screen, it finishes the picture and then 

blanks out the screen and returns the 

curser to home (if you are using the 

™.. UDB). 


SPORTS.BAS 
Simple CAI program to give you multiple 
choice questions on sports. If you 
guess the right answer, you are congratulated. 
If you guess wrong, you are given the 
right answer. At the end of the quiz 
ou are told how many you had right 
and wrong. 


STARS.BAS 

By Bob Albrecht of Peoples Computer Co. 
A number guessing game in which the 
number of asterisks printed shows 

how close you are to the number. 


STOCK.BAS 

P. 209-211 in 101 BASIC Computer Games. 

A stock market simulation game revised 8/18/70 
by D. Pessel, L. Braun, and C. Losik, Huntington 
Computer Project, SUNY. Lets you lose money on 
the stock market without having to pay out any 
money--- other than the small fortune you spend 
in upgrading and maintaining your micro. 


TAKEAWAY .BAS 

By Michael Ruf and Rick Mack. 

The game seems to be well written, 
but some of the coding, probably 
intended to do something with 

an intelligent terminal, gives 
confusing output on my TDL-VDB. 
The game has several players 
alternately taking away asterisks 
from an asterisk collection... 
something like the game of CHOMP. 


TDRILL.BAS 
Author: Jim Kennedy, CACHE 
Date written: July 14, 1981 
This is a simple typing drill 
program designed to give a 
beginning typist extra drill 
and practice. Rather than 
generate the letters and words 
with a random letter generator, 
as is done in some other 
typing drill programs, this 
one uses data lists to 
supply the letter groups. 
This gives more control over 
which letters are used in 
the early lessons when only 
a few keys have been introduced. 
The student may correct a mistake 
by backspacing if it is noticed 
before the CR has been hit, and 
the mistake is not noted. However, 
if a line is not perfect when the 
CR is hit, the student will be 
* told so, and will be asked to 

yy try again. At the end of each 

®/ 12 line drill (6 lines X 2), the 
student will be told how 
many lines were typed to get 
the dozen correct. Another drill 


Cah hen o.e paicKcea, or Tie stuaent 
can terminate the program, and 
receive a count of the number 

of lines right and the total 
number typed. This program 

will be used in the future with 

a different data list to continue 


Oris lesson series, starting 


with lesson 13. 


TENNIS.BAS 
A Mult. choice quiz on tennis, with a 
question technique similar to SPORTS.BAS 


TEXT.BAS 

An introductory information program about 
some of these (and other) programs. 

It is obvious that most of the programs 

on this disk set came from a PDP-11] computer 
in a school. Many of these programs are 
from DECUS (Digital Equipment 

Computer Users Society), a group didicated 
to the distribution of public-domain 
programs---similar to the CP/M Users Group. 


TICTAC.BAS 

This is an expanded tic tac toe game played 
on a9Q9xX 9 grid. You enter your moves 

as grid coordinates and the computer (often 
"thinking" for over a minute) prints the 
position of your move and its move. You have 
to get 5 across, down, or diagonal to win. 


oO: those with the patience to wait between 


:) 
M4 


oves, this game could be an enjoyable challenge. 
It is also good for grid coordinate practice. 


TRAP.BAS 

P, 224-225 in 101 BASIC Computer Games. 
Written by Steve Ullman, and modified by 
Bob Albrecht of People's Computer Company. 
Another "guess the mystery number" game. 


TTTOE.BAS 

Tic Tac Toe game. Usually plays well, but 
periodically gives error message: Subscript 
out of range on line 84, usually when no one 
is going to win. This one too, may benefit 
from some user de-bugging and feedback. 


TVPLOT.BAS 

Originally written in FOCAL by Mary Cole 

and converted to BASIC-PLUS by Dave Ahl. 

This program produces various funny TV plots. 
Good for a laugh or two. 


TYPING.BAS 
Author not mentioned, but 
it could have been written 

y Michael Ruf. It uses the 
"WAIT on line 80 that hangs up 
my system. It may work with 
a serial terminal that uses 
ports 72(status) and 73. 
It is intended as a typing 
drill program, with the 

« « ster strinaos aenerated 


xy a random generator. 

Rather than correct this 
program, I wrote my own typing 
drill program. (see TDRILL.BAS). 


WEKDAY.BAS 


>: 234-235 in 101 BASIC Computer Games. 


dapted from a GE timesharing program by 

Tom Kloos of the Oregon Museum of Science and 
Industry and further modified for XITAN Disk 
Basic. 


WISHES.BAS 

A silly wish poem writing program. It is 

in a nice conversational tone for primary 
school children. It could do more with the 
input it gets, but the author probably felt 
the intended audience wouldn't notice. This 
program has good possibilities for expansion 
into something interesting for slightly 
older children. 


D> 


POLY-vy 
#PVI19 


K&M Company 


TORRANCE. CA 90503 


is) 


0 


f 


-CATALOG078 
/ ASM 
/ COM 
/DUP COM 
ABSTRACT078 
BMAPORIGASM 
BMAPORIGCOM 
CRCK COM 
CRCKLISTO78 
D COM 
DUH COM 
DUH 280 
DUU ASM 
DUU COM 
DUU DOC 
EPROM ASM 
EPROM DOC 
FMAP COM 
IF COM 


MAKE ASM 


NOTATE ASM 
More.. 
NOTATE COM 


PATCH ASM 
REPEAT COM 
SDCOPY ASM 
SDCOPY COM 
SDCOPY DOC 
SWAPCOPYASM 
SWAPCOPYCOM 
SWAPCOPYDOC 
TESTPROTBAS 
U-G-FORMLIB 
UN COM 
VOLUME7 8DOC 
XREFPRN ASM 
XREFPRN COM 
37 file(s). 


CPMUG vol. 78 


23 directory entries remaining. 


D>STAT O: 


Bytes Remaining On O: 7k 


D> 


2/11/86 


TYPE O:-CATALOG.078 
CP/M Users Group VOLUME 78 


CP/M Users Group 
1651 Third Ave. 
New York, N.Y. 10028 


DESCRIPTION: Utility disk. 01/24/82 


NUMBER SIZE 


8K 

5K 

8K 
078.1 4k 
078.2 1K 
078.3 1K 
078.4 10K 
078.5 1K 
078.6 2K 
078.7 2K 
078.8 3K 
078.9 10K 
078.10 3K 
078.11 51K 
078.12 7K 
078.13 14K 
078.14 8K 
078.15 2K 
078.16 4K 
078.17 1K 
078.18 2K 
078.19 12K 
078.20 3K 
078.21 1K 
078.22 3K 
078.23 1K 
078.24 10K 
078.25 1K 
078.26 3K 
078.27 14K 
078.28 2K 
078.29 3K 
078.30 1K 
078.31 5K 
078.32 23K 
078.33 3K 


Cataloged by Ward Christensen 


D> 


NAME 


-CATALOG.078 
ABSTRACT. 078 
U-G-FORM.LIB 
VOLUME78.DOC 


/.ASM 
/.COM 
/DUP.COM 


BMAPORIG.ASM 
BMAPORIG.COM 
CRCK.COM 
CRCKLIST.078 
D.COM 


DUH.COM 
DUH.2Z80 
DUU.ASM 
DUU.COM 
DUU.DOC 
EPROM.ASM 
EPROM.DOC 
FMAP.COM 


IF.COM 
LPRINT.ASM 
MAKE.ASM 
NOTATE.ASM 
NOTATE.COM 
PATCH. ASM 
REPEAT.COM 
SDCOPY.ASM 
SDCOPY.COM 
SDCOPY .DOC 
SWAPCOPY.ASM 
SWAPCOPY .COM 
SWAPCOPY .DOC 
TestProt.BAS 
UN.COM 
XREFPRN.ASM 
XREFPRN.COM 


COMMENTS 


CONTENTS OF CP/M VOL. 078 
Abstracts of programs 

Users Group submission form 
DOC on programs not having some 
other form of documentation. 


Quickie SUBMIT from command 
line. 

Same as /.ASM but produces a 
second copy of $$$.SUB to 
facilitate re-executing 
Prints 2.2 disk allocation 
bit map 

to check files on this disk 
File of all file CRC's 

Type D to see if any files 
have been lost on this disk 

Disk Utility for the H/Z-89 
Source for DU relocator 

Disk Utility Universal, works 
with 1.4 and 2.2 

DOC on above 

SSM PBl PROM prog. rtn. 

DOC on above 

File map updated for 1024 dir 
entries and CP/M 1.4 or 2.2 
Continue or abort a SUBMIT 
Paginated file output to LIST 

Make a file a different user # 

Add comments to an .ASM file 
«COM of above 

Patch CP/M to show user: "A0>" 
Repeat a SUBMIT "nn" times. 
Single-disk file copy program 

n 


Another single disk file copy 
program 
n 


Sample to test UN.COM 

Unprotect MBASIC programs 
Prints a cross-reference from 

a PRN file to CP/M LIST device 


2e_PG JEvULUMNSs5.D0C 
CPMUG volume 78, documentation. 
01/24/82 Ward Christensen 


I created this file is an attempt to supply documentation 
for all files which do not have a separate .DOC file. 
The following files have their own separate .DOC file: 
o DUU, EPROM, SDCOPY SWAPCOPY 


====> /.ASM, /.COM, /DUP.COM 

John M. Kodis, author, says: The "slant" program reads a 
command line which may contain several program invocations. A 
$$$,SUB file is built with these commands. This file is then 
executed. 
For example, the command line: 
/ asm copy; load copy; dir copy*.*; type copy.prn 
will build a file containing commands to assemble and load the 
file named ‘copy', search the directory for all copy programs, 
and type the COPY.PRN file. 
===> BMAPORIG.ASM, BMAPORIG.COM 

Lauren Guimont wrote this "bit map print" program for CP/M 
2.2 because the ALLOC program (CPMUG vol 40 the latest) was 
hard-coded for CP/M 1.4. 
USAGE: BMAPORIG or BMAPORIG disk: 
EX: BMAPORIG B: 

‘ see CRCK.COM 
Keith Petersen's program is self documenting - just 
oo CRCK with no operands. It then says: 
CRCK [drive:]<filename.filetype> [F] 
Examples: 
CRCK MYPILE.ASM Check only MYFILE.ASM 
CRCK *.ASM Check all .ASM files 


CRCK *,* F Check all files and make file 
of results <CRCKLIST.CRC> 


===> D.COM 
Self documenting via "D HELP"; 


fn, ft are specific, afn aft may be ambiguous (? and * allowed) 


D SET sets all filenames on disk into D.COM 

D shows added/erased files since D SET was done 
D ADD fn.ft adds a file to D.COM ("registers” it) 

D DEL afn.aft deletes a file from D.COM ("unregisters" it) 
D CU to Clean Up by selectively adding, erasing, 

or deleting files. 
D afn,aft 5-up directory list (e.g. D *.* or D *.ASM) 
oO (avoid fn of SET, ADD, DEL, CU) 


Xo ====> DUH.COM, DUH.Z80 

\ Bill Norris put some documentation in the front of 

V/\ the .280 file. NOTE this is not DU itself, but rather a 
relocater for DU. It appears you would have to assemble 
DU twice, once for each address. DUH then is a program 
to comvare the two .COM versions of DU, and make one 


re ocatable version of them. 


=s==> FMAP.COM 

Self documenting via "FMAP H": 
FMAP by Ward C. Help: FMAP fn.ft [option] [.suboption] 
En.ft: ? and * allowed. 


Ort Console out? To disk as: Usage: 
/ Y (across) 
B Y + bit map 
D Y $1 $2fn.ft $3 for SUBMIT 
F Y fn.ft UCAT input 
K fn.ft nnk 
L Y + seq# + #K 
M N $1 $2 $3fn.ft SUBMIT MODEM 
Q N fn.ft 
P N $1 $2fn.ft$3 SUBMIT PIP 
Unnn Users group catalog nnn to -CATALOG.nnn 


Suboptions: .S selects names as listed; .P output to printer; 
-Unn selects only user nn 


Some examples might make things clearer: 
B>fmap *.asm 


FMAP V2.3 - 12/07/81 MAP H for help 
FILENAME TYP EX RC #K EXTENTS... 


/ ASM 00 OO1F 04 12-15 
BMAPORIG ASM 00 004E 10 02-0B 
DUU ASM 00 0080 16 32-41 
DUU ASM 01 0080 16 42,79-83,88-8B 
DUU ASM 02 0080 16 8D-9C 
UU ASM 03 0014 03 9D-9F 


PROM ASM 00 003D 08 43-4A 
LPRINT ASM 00 000D 02 0C-OD 
MAKE ASM 00 005E 12 CO-CB 
NOTATE ASM 00 0017 03 4D-4F 
PATCH ASM 00 0017 03 CC-CE 
SWAPCOPY ASM 00 0070 14 66-73 
XREFPRN ASM 00 0080 16 1B-2A 
XREFPRN ASM 01 0035 07 2B-31 

14 FILES, 130 K 


EX is the extent number 

RC is the hex record (sector) count. Someone asked if this 
is different for double density. No. This is the 
"logical" sector count, i.e. in 128-byte "chunks" 

#K is the decimal number of K in the extent. This properly 
reflects single/double density, i.e. single density 
typically allocates in 1K blocks, double in 2K or more. 
(Note the #K is still not right for files on a hard 
disk which are allocated with 4K or larger groups, 
technically, with "EXM>0" in the BIOS) 

EXTENTS is the physical location, in hex, of the file on disk. 
Contiguous blocks are shown as nn-mm; 


Further info on extents: a file is allocated in blocks of 1K, 
2K, etc, on disk, depending upon the density. The directory 


Orne in block 0, and usually occupies blocks 0 and 1. The 
£ 


irst file placed on an empty disk starts in block 2. Each 
directory entry keeps track of 16 blocks; in double density, 
each keeps track of 8 blocks, because each block is 2K. Other 
options may be applied to larger disks, such as having one 
directory entry keep track of 32K. 


sooc=z>d IF.COM 


Allows you to conditionally abort or continue a subj! it, 
depending upon whether a file exists or not. 


Examples: 
if foo.zot continue ;continues submit if foo.zot exists 
if foo.zot abort saborts submit if foo.zot exists 


° ==> LPRINT.ASM 
P.P.H. Lee, in the .ASM file, says: 
TO EXECUTE TYPE: 
LPRINT ON - EQUIVALENT TO STAT LST:=LPT: 
LPRINT OFF ~- EQUIVALENT TO STAT LST:=TTY: 


===> MAKE.ASM 

Its author, Terry Lewis, writes: Changes directory user 
number, making program available to different user without 
rewriting program on disk. Changes only the user number. 


COMMAND : 
MAKE PIP.COM 5<cr> or 
MAKE *.ASM 3<cr> or 
MAKE ST?T.C?L 4<cr> or 


(any ambiguous or) ( Desired ) 
MAKE (unambiguous CPM ) (USER number) 
( filename.typ ) ( 0 to 15 ) 


RESULT: 
The files specified will be changed from their current user 
number to the user number specified as the second command 


variable. They will no longer exist under the old user number 


oe" will show up under the new user number. 
=o==> NOTATE.ASM, NOTATE.COM 


This program was originally distributed on volume 29, but 
somehow had many memory "hits" in it. Martin E. Nason fixed up 


those hits so it would re-assemble. 

The program is used to add comments to .ASM files which 
have "sparse" comments. It types the file, and on any line 
which does not have a comment, prints the line, a tab, a 


semicolon, then awaits input. If you press return, the line is 
left, without the "tab;". Anything you type will be added to 


the line. 


sse=> PATCH.ASM 


Adequate documentation to implement it is contained in the 


-ASM file. 


==> REPEAT.COM 
Repeat a .SUB file "nn" times. Used in two "phases": 
(1) type "REPEAT nn" to set things up (just stores a count 
at 8. 
(2) Place "REPEAT" in your .SUB file immediately before a 
line re-submitting the original file. 
EX: 


First, type 


© REPEAT 5 


»/, Then have your submit file be: 
J) blah 

blah 

blah 


reveat 


Suomit £00 


When repeat executes with no operands, it decrements the 
count at 8, and if 0, erases $$$.SUB. 


===> TESTPROT.BAS, UN.COM 
Author Bill Norris says: UN.COM is used to recover 
rotected MBASIC programs. TESTPROT.BAS is a simple demo 
program which has been written in MBASIC and has been 
protected. (No real reason for including it though... Also, if 
you compile it, the program will run a LOT slower.) 

Unprotects protected programs. No other documentation 
exists other than that which is part of the .COM file. The 
.COM file acts as both a normal executable program, and as the 
documentation. ( It may be sent to the console via 'A>TYPE 
UN.COM'. Also, part of the above documentation will go to the 
console if the user types ‘UN HELP'.) 


===> XREFPRN.ASM, XREFPRN.COM 
P.P.H. Lee modified CPMUG XREF from volume 8 (or 36?) 
to work with PRN files. 
Usage: XREFPRN name.PRN 
Goes directly to the CP/M LIST device. 


D> 


22PE O:3DUU.DUC 
DUU.DOC 
by Ward Christensen (revised 10/23/81) 
Includes notes by Ron Fowler for DU-V75. 


HOW TO USE DU ver 7.5 DISK UTILITY 
(Extended and called DUU on CP/MUG v.71) 


f 


9 


\ 


DUU, Disk Utility-Universal, is an enhanced version of 
previous DU programs, on CP/MUG volumes 40 and 46. 


The primary change over the earlier CP/MUG versions is the 
additions by Ron Fowler, to make DU work with virtually any 1.4 
or 2.2 system, single or double density. 


INDEX 
0.0 Changes from DU-V75 
1.0 INSTALLATION: 
2.0 USE: ; 
2.1 COMMANDS, BY FUNCTION (quick reference) 
2.2 ALPHABETIC COMMAND SUMMARY 
3.0 NOTES 
4.0 INTERPRETATING DIRECTORY DATA 
4.1 SINGLE DENSITY 
4.2 DOUBLE DENSITY 


0 CHANGES FROM DU-V75 


The primary change is that all routines which original- 
y accepted a decimal number, such as /, +, ~, and Z, which 
ere changed to HEX in DU-V75, are now changed BACK to decimal. 

The "F" command now works completely under 1.4 and 2.2, 
and finds all users, and even erased files. Ambiguous file 
names are now allowed. After using "F" with a specifid name, 

F with no operands will find the next "occurrence" (i.e. 
extent, or earlier erased copy, etc) of a file. 

This is a matter of taste - I don't believe in 
"babying" CP/M users with "press any key to continue" when more 
than 16 lines has scrolled by. I removed these, so use “S to 
suspend scrolling of the "?" (help) output. 

The "U" command has been deleted, since its only 
purpose was to change users for the sake of the old "F" 
command. The new "F" command obsoleted the "U" command. 

Made sure + and - check the "NOTPOS" flag; that was a 
"loophole" that could "mislead" you. 

Added ability to put Hex into default decimal fields. 
Needed this to transfer files, where their hex length is known, 
i.e. a file 29h sectors long in contiguous extents may be read 
into memory via: <<;+;/29h 

Added "E" (erase screen) command. Store the character 
Sequence, OffH terminated, at 104h. Useful as in "e;+70;z20;/" 
ee sit, loop. The screen clear "e" causes the display to 

sit". 

Set "@" when using "F" command, so for example to erase 
a file: "ffoo.zot;ch@,e5";w Also change "not found” of "F®" 
command so it aborts, thus preventing, in the above ex., the 
actual change-and-write. 


1.0 INSTALLATION: 


soo 


The 7.0 and later versions of DU are designed to be 
installed with a minimum of tranuhie ne hal OE ay ae. ee aga 


Pog 


cases, no changeS to tue Source f£is€ SF 1OUsG JE see maa goer --- 
DU up and running. This is because DU uses the disk paramter 
block of CP/M to determine the characteristics of the disk 
environment. (see the disclaimer for certain non-standard 


versions of CP/M 1.4). ; 
The only parameter that should need to be changed will 
be the clock speed flag at 103H. Leave this byte zero if you 
ave a 2 mhz clock. Patch it non-zero for 4 mhz. This is only 
needed for the "Z" (sleep) command. An alternative is just to 
use larger numbers when running 4mHZ or 5MHz. 


2.0 USE: 
An initial command string may optionally be placed as an 
operand of the original DU command, i.e.: 


A>DU G0;D;G2;=OK<D><A><1A>;D 
For example, if you want to only MAP the disk, then exit: 
A>DU M;X 


Once DU is running, it expects single-letter commands much 
like SID or DDT. For ease of use, multiple commands may be 
placed on one line, separated by ";". In addition, a given 
command or string of commands may be repeated, either indef- 
initely (until “C is pressed), or a given number of times. 


To avoid an accidental “C from dropping out of DU, only an 
explicit "X" command will exit DU. 


ee. COMMANDS, BY FUNCTION 
Help: 
? request help 
Positioning: 
Gnn by allocation group 
Snn by sector 
Tnn by track 
+nn going ahead nn sectors 
-nn going back nn sectors 
I/O: 
R Reads sector 
W Writes sector 
< Puts current sector "away" into a buffer 
> Recalls previously saved sector 
Displaying: 
G Shows current group, track, sector 
M Maps the disk - where are the files 
Mxx Map starting at group xx 
D Dump the sector (hex + ascii) 
re] A Dump sector in ASCII 
H Dump sector in hex 
Vnn Views (like CP/M TYPE) nn sectors 
4 Shows disk parameters, also # of sectors 
stacked and used via "<<" and ">>" 
Changing: 


CHnn,val Change data in hex 


Oe 
S 
4 


LAann,;Vvas Change data in ascii 


N 
Unn 


Searching: 


Misc: 


Fname 
F 
=aaaa 


ann 


insert new disk 
Change user to nn 


Find a file in the directory 

Find next occurrence (extent) of same name 
Scan for aaaa (in ASCII) from current 
sector on 


Sleep (nn tenths of a second) such as to allow 
viewing data before it scrolls off 

Log in disk x 

Turn on/off printer output toggle 

Before any command does it "quietly" 

Exit to CP/M 

Repeat previous command nn times 

(indefinitely if nn omitted) 


ALPHABETIC COMMAND SUMMARY 


/nn 


=string 


Prints the disk parameters 


advance 1 sector (if below track 2, 

this advances to next numerical, if 

2 or >, advances based on CP/M's normal 
sector scrambling algorithm, i.e. so + 

will get the next logical sector of the file 


backs up 1 logical sector 


Note + and - may take an amount: 
for example, +15 steps in 15 sectors. 


Repeats entire command. Defaults 
to "forever". nn may be 2 to 65535 


Saves current sector in a save buffer 
also resets buffer pointer used by << and >> 


Saves current sector, bumps memory pointer. 
Thus subsequent "<<" saves "next" buffer in 
memory. Use "<" to reset, or ">>" to 
sequentially retrieve the buffers, such as to 
move several sectors from one place on disk 
to another, or to another disk, or just to 
memory (stored at 2000H where DDT or SID 

can subsequently access them) 


Ascii search, starting at current 
sector. <xx> hex may be imbedded, 
Or used alone: To find "IN OFEH": 
=<db><fe> 

Ignores bit 7 unless <xx> is used. 


Since ";" is a command delimiter, you 
have to use <3b> to search for a ";". 


Also, since "<" is a hex-escape char, 
use << to meane a single "<", 


N-O-T-E the special symbol "@" contains 
the displacement at which the match occurred. 


{ with <xx> escape to nex, 


O64 
rd 
> 


or 


It may thus ve supsequent y usea inavt 
command, as in: 


=LIX;CA@,LXI;W 


would search for the string LIX, change 
it to an LXI, and write it back. 


> Gets saved buffer. < and > may be used 
to move a sector to another place. 


>> Restore "oldest" unrestored sector saved 
by "<<" command. This command may be 
"buried" in the middle of an infinite 
repeat "/", because it will stop operating 
when there are no more sectors in the buffer. 


? Gives command summary 
A Dump sector, ASCII only 
CHaddr,val,val,val... change hex in sector 
CAaddr,char string... change ASCII in sector 
NOTE that <xx> may be hex imbedded 
in the Ascii: ca0,OK<d><a><la> 
----> Use W to write changes to disk. 
Note that the C command echoes 
the overlaid data for verification. 


CHaddr-addr,byte 
CAaddr-addr,byte repeats a change 


D Dump sector, hex + ASCII 


Fname print directory for file "name", 
then positions to it's directory 


sector. 
F Find next occurrence of name in dir. 
Gnn Position to group nn and read. 
G Shows current position 
B Dump sector, hex only 
L Re-logs in the current disk. You may pull 


out a disk, put in a new, and "L" just 
to log it in. (See "LOGGING IN DISK" in NOTES 


below) 

Lx Logs in disk 'x', such as: LB 

M Dumps a map of the group allocations 
for files. 

Mn Shows which file is allocated to 


group "n". 


N Resets CP/M via the BDOS. This may 
make it possible under some implementations 
of CP/M to change the disk format (e.g., density, 
sides, etc) 


P Toggle printer switch on/off 


Snn 


Tnn 


Vnn 


0 
M 


zwu1let: Preceeding any command, suppresses console 
output 


Reads the sector currently positioned to 
into memory. Note R (Read) is implicit in 
the G, +, and - commands, but N-O-T in the 

S and T commands (I did it because I was 
tired of disk reading after T command before 
I had a chance to issue the S command) 


Position to sector nn, and read 
Seek to track nn (no read) 


Logs user 'x' for next F command. Gives 
'?' error if not CP/M version 2.x. 

(Note "F" no longer needs this - finds 
ALL files - erased, any user, etc) 


Views the current sector. 
(assumes ASCII data) 
Views nn sectors 


Write back the current sector (N-O-T-E may 
not be used after an F command, as CP/M was 
used to find the file in the directory 


Exit back to CP/M (Must press return). Ctl-c 
was too easy to hit over modem lines, so I 
decided on 2-byte (X, CR) to exit. 


Sleep - causes the program to pause, such 
as to look at a dump. Z is 1 sec. @Znn 
is nn tenths of a second on a 2 MHz 8080. 


ULTIPLE COMMANDS: May be separated by ";" 


Example: the following commands will erase the 
b disk directory to all E5's: 


1b log in b drive 

gd position to dir. 
ch0-7£,e5 fill with e5 

< save the sector 
>swit3/16 restore, write, next, 


repeat 16 


----This could be shortened to: 


1b;qg0;ch0-7f,e5;< 
>swit3/16 


oO DUMP COMMANDS: All dump commands (D, A, H) may be optionally 
followed by a starting and ending address: 


DO,7F 
. D3,5 
ah A20,3F 


is the same as just D 


* LOGGING IN DISK: In the original DU, I logged in the disk the 
‘oe DIT now does. Then I found that when vou had a blown 


directory, you DIDN'T want to log the new GiSkK ine snus « 
changed DU to just change which disk was selected. Then along 
came double density, with its attendant "select density" 
functions, and Ron apparently put this back in. So, it now 
sometimes works for double density, but makes DU very 
"intolerant" of disks with un-readable directories. A 
solution is to log in a disk which is OK, and is of the same 

ensity as the blown disk, then put in the blown disk WITHOUT 
logging it in. 

However, you are now opening yourself up to possible 
problems because of the buffering of physical sectors in the 
BIOS. The best technique, (but not guaranteed), would be to 
seek to the unused inner tracks of the first disk, do the 
read, THEN change disks. That way if it writes anything, you 
won't have destroyed anything. ...assuming the disk is not 
completely full. Another technique, assuming the second disk 
does not contain a CP/M system, would be to seek to track l, 
then do the read there, then change disks to the blown one. 


Regarding the << and >> commands: 


* Up to 255 sectors (only because its a 1 byte counter) 
may be saved by <<. 

* ANY TIME "<" is executed, the buffers are "thrown away". 

* One ">>" to fetch a saved buffer and make it available 
for writing, may be issued for each previous "<<". 

* The "M" (directory map) command uses an area of memory 


for a buffer. To minimize problems, the Map buffer is 
placed a the END of the CURRENTLY HIGHEST USED "<<" 
buffer. On small systems, where a "lot" of buffers have 
been saved via "<<", the "M" command might report that 
it ran out of memory. Executing "<" (or ">>" sufficient 
times for it to tell you there are no more sectors 


re) in the buffer) will then make room available at a lower 


» 
t 
ye 


address, for "M" to use for the directory. 


The following command could be used to move your directory 
out to the end of your disk. (to keep a "back up" copy). 


1) Map the disk to find an open space at the end: 


MeO map starting at e0. 
2) Suppose EO is wide open. Capture the directory: 
gO 
<< 343/26 
4.0 INTERPRETATING DIRECTORY DATA 
4.1 SINGLE DENSITY 


The following explains the format of a CP/M directory entry 
as shown by DU, using either the "F" (find file) command, 
or just doing "D" (dump) of the directory sectors, which 
are located in groups 0 and 1 on a single density disk. 


Sample result of "FSID.COM" command: 


40 00534944 20202020 20434F4D 0000003A *.SID COM...:* 
50 33343536 3738393A 00000000 00000000 *3456789:........* 


First line - 


40 00534944 20202020 20434F4D 0000003A *.SID COM...:* 
tro oti ! tt 11 | l 


w-—-—-—-nex %(1.€@ name-r---— file name 


in ASCII 


—~— 


I 
| 
extent-* 


— — 
5 


file size in sectors- 


file active Other values (e.g 03) = User # 
file erased 
-displacement of line in directory sector 


—_——— 
——— 
ty 
ul 
ou 


Second line - 


50 33343536 3738393A 00000000 00000000 *3456789:........* 
l | I 
| I *“- allocation groups 
laa allocation group numbers-----~* just happened 
to be printable 


2 DOUBLE DENSITY 


The following is a sample of FSID.COM running on double 
density system: 


:FSID.COM 

00 00534944 20202020 20434F4D 0000003A *.SID COM...:* 

10 38003900 3A003B00 00000000 00000000 *8.9.:.3.....0066% 

G=0000:00, T=2, S=1, PS=0 

The primary difference is that the groups now occupy 

2 bytes, i.e. "38 00" "39 00" ... This follows the INTEL 
or: CP/M convention of putting 16 bit values high-byte-first. 

hus it means group 0038, 0039, etc. 


Note that in double density, each group stood for 2K, not 1K, 
so there were half as many groups for the same file. 


Be VERY careful when patching a directory under double density. 
I once made the mistake of putting, for example: 


chl0,38,39,3a,3b... 
When I went to read this file, it tried to access group 3938, 
with resultant angry exclamations from the disk stepper as it 
attempted to go south to Peoria for the data. 
10/23/81 Ward C. 


D> 


1a PB EPROM, DOC 
RRA KARA KARE KKK REE KER EERE KER ERE RKEREREKERREREEREREREKK 


EPROM.DOC 
LAST MODIFIED 9/27/80 


EPROM PROGRAMMER SOFTWARE FOR RUNNING AN SSM - PBl 
2708/2716 PROGRAMMER WITH CP/M UNDER DDT 


TO RUN THIS PROGRAM, TYPE: 
DDT EPROM.COM(CR) 


THE CONSOLE WILL RESPOND WITH: 


me Se se Ne Ne Se Me Me Se Ne Ne Ne MO Ne NO 


;DDT VERS #.# 
*NEXT PC 
rete 0100 


INSERT A HEX FILE TO BE PLACED IN EPROM BY ENTERING: 


IFILENAME. HEX (CR) 
;RIBIAS] (CR) 


@ te Se se Ne ss: 


(NOTE THAT BIAS WILL ALLOW THE ENTERED PROGRAM TO RESIDE 
WITHIN 103H TO 'START' AS REQUIRED EVEN THOUGH THE PROGRAM 
WAS ASSEMBLED FOR EXECUTION OUTSIDE THIS RANGE) 


TO START THE PROGRAM FROM DDT, ENTER EITHER 'G(START:)' 
OR 'G100'. THE PROGRAM WILL ASK FOR EPROM TYPE SO AS 

TO SET THE PROPER SIZE (1K FOR 2708 AND 2K FOR 2716/2516) 
AND PROGRAMMING ROUTINE. 


SUPPORTED FUNCTIONS ARE COPY, PROGRAM AND VERIFY WHICH ARE 
SELF EXPLANATORY. THE AUTOMATIC SEQUENCE FOR PROGRAMMING 
AN EPROM IS TO FIRST CHECK FOR FULL ERASURE, THEN THE 
PROGRAM CYCLE, FOLLOWED BY THE VERIFY ROUTINE. 

(ANY FAILURE RESULTS IN AN ERROR MESSAGE AND A BELL 

SO AS TO NOT GO UNNOTICED.) 


AS CONTROL IS PASSED TO DDT AND YOU WISH TO 
RETURN TO THE PROGRAMMER, JUST ENTER 'G' AGAIN. 


EXIT FROM THE PROGRAM BY ENTERING A CONTROL C 


me Se Se Se Se Ss Se Ne Ne Se Se Se Se Se Se te Se Se Se Ne Me we we 


RREKEKEKKKKKEKERERKEEKKEKRRREKREKERERRREREEEEREKEERKKEEKREKEKKEEREKKEK 


° 
v 


hanes OV LUPLe 14 


SDCOPY .DOC 
REVISION OF CPMUG 29.30 


SDCOPY IS A PROGRAM WHICH ALLOWS FILES TO BE COPIED FROM 
ONE DISKETTE TO ANOTHER ON A SINGLE-DRIVE CP/M SYSTEM. IT 
WILL COPY ONLY ONE FILE AT A TIME, AND THIS FILE IS SPECIFIED 
WHEN THE SDCOPY COMMAND IS ENTERED. SDCOPY IS INVOKED AS 
FOLLOWS : 


SDCOPY <FILE NAME>.<TYPE> 
EXAMPLE: 
SDCOPY MYFILE.ASM 


THE ABOVE COMMAND LINE CAUSES SDCOPY.COM TO BE LOADED AND 
EXECUTED. THE PROGRAM FIRST IDENTIFIES ITSELF AND THEN PROMPTS 
FOR THE INPUT FILE AS FOLLOWS: 


LOAD SOURCE DISK, TYPE S: 


AFTER YOU LOAD THE SOURCE DISKETTE AND TYPE "S", THE DISKETTE 
DIRECTORY IS SEARCHED FOR A FILE WITH THE NAME YOU FIRST 
ENTERED. IF THE FILE IS NOT FOUND THE MESSAGE "WRONG DISKETTE" 
IS DISPLAYED ON THE CONSOLE. IF THE FILE IS FOUND, IT IS READ 
INTO MEMORY UNTIL ALL AVAILABLE MEMORY IS FILLED (TO JUST BELOW 
THE CCP) OR THE END OF FILE OCCURS. THE FOLLOWING PROMPT WILL 
THEN APPEAR: 


LOAD DESTINATION DISK, TYPE D: 


Ove FIRST TIME THE OUTPUT DISKETTE IS LOADED ANY FILE WITH THE 


of 


of 


SAME NAME IS DELETED. A NEW EMPTY FILE WITH THE NAME YOU ENTERED 
WILL BE CREATED ON THE OUTPUT DISKETTE. THE PART OF THE INPUT 
FILE ALREADY IN MEMORY WILL THEN BE WRITTEN TO THE DISKETTE. 


IF INPUT ENDED WITH AN END OF FILE (CP/M END OF FILE, NOT CTL-Z), 
THE COPY OPERATION IS COMPLETE WHEN THE RECORDS IN MEMORY HAVE 
BEEN WRITTEN TO THE OUTPUT DISKETTE. IF AVAILABLE MEMORY WAS 
FILLED BEFORE END OF FILE, HOWEVER, THE PROGRAM WILL AGAIN 
PROMPT FOR THE SOURCE DISKETTE, AND THE PROCESS IS REPEATED. 
AFTER THE FIRST PASS THE OUTPUT FILE IS NOT RECREATED, BUT IT 

IS SEARCHED FOR IN THE DIRECTORY. IF IT IS NOT FOUND THE 
FOLLOWING MESSAGE WILL APPEAR ON THE CONSOLE: 


WRONG DISKETTE 


AFTER THE PROCESS IS COMPLETE, OR IF AN ERROR OCCURS, THE 
FOLLOWING MESSAGE IS SENT TO THE CONSOLE: 


REBOOTING VIA JMP 0000, PRESS RETURN 


AT THIS TIME YOU SHOULD INSERT THE DISKETTE YOU WANT FOR NORMAL 
OPERATION ON YOUR SYSTEM AND PRESS THE "RETURN" KEY. 


CAUTION 


3 — 5 5h 


EVEN THOUGH THIS PROGRAM WORKS FINE ON MY SYSTEM UNDER CP/M V1.4, 
YOU SHOULD VERIFY THAT IT WORKS CORRECTLY ON YOUR OWN SYSTEM WITH 
SOME UNIMPORTANT FILES BEFORE YOU TRY IT ON A VALUABLE ONE. THIS 
IS ESPECIALLY TRUE IF YOU HAVE A DIFFERENT VERSION OF CP/M OR HAVE 
SOME NON-STANDARD I/O ROUTINES OR RESIDENT ROUTINES BETWEEN 100H 


Aw TYR COP, THER PROGRAM DUES USE STANDARD CP/M 1/0 CALLS, dul 
IS ALWAYS BETTER TO BE SAFE THAN SORRY. 


BE ESPECIALLY CAREFUL TO INSERT THE CORRECT DISKETTE EACH TIME. 
IF YOU LEAVE THE INPUT DISKETTE IN ON THE FIRST PASS WHEN 

THE PROGRAM EXPECTS THE OUTPUT DISKETTE, THE REMAINDER OF 

THE INPUT FILE WILL BE LOST. IT WILL BE DELETED, AND WHATEVER 
IS IN MEMORY WILL BE WRITTEN BACK ON THAT DISKETTE. YOU 
SHOULD PHYSICALLY WRITE PROTECT THE INPUT DISKETTE IF POSSIBLE. 


O> 


TYPE O:SWAPCOPY.DOC 


A file transfer utility for single drive systems. 


° Swapcopy has been designed to allow a single drive system 


to be used to transfer any file or group of files from diskette 
to diskette. There are no restrictions on the number or size of 
the files. 

The program reads the file specification given in the 
command line, prompts the user to insert the disk containing the 
source files, and begins reading files until the transient 
program area is full or all the files have been read into memory. 
The user is then prompted for the destination disk, and the files 
are written out. 

If the entire transfer can be completed in one pass, the 
user is prompted to insert a system disk (i.e., one which has 
CP/M on it) in drive A, at which point control is returned to 
CP/M. 

If more than one pass is necessary, the user will again 
be asked for the source disk, then the destination disk, and_ so 
on, until all the files have been transfered. 


The command line expected is as follows: 
A>swapcopy <file specification> [pl][q][rl<cr> 


where <file specification> is an ambiguous or unambiguous file 
specification, and [pl], [q], and [r] are options, as explained 
below. 


ew ee ee ee 


When the system has asked for a particular disk, you 
should hit return to acknowledge that the disk is ready. You may 
instead hit control 'C' to abort the copy program. Any other 
response will print a message which explains the acceptable 
responses to the user. 


There are three options available: the 'Print' option, 
the 'Query' option, and the 'Report' option. 


The Print option will print an 'O' each time a _ source 
file is opened, a 'C' each time a destination file is closed, an 
'M' each time a new file is made, and an 'r' or 'w' for each 

ector read or written. This option was put in mainly for 
ebugging and verification, but it makes an interesting display. 


The Query option will print the name of each file which 
matches the file name given in the command line, and ask _ the 
operator if the file under consideration should be copied. Any 
response beginning with 'Y' or 'y' is taken as affirmative, while 
any other response will bypass the file. 


The Report option prints the name of each file transfered 
when the complete file has been copied to the destination disk. 


° Any questions, comments, complaints, suggestions, or 
criticisms should be directed to the author: 


John M. Kodis 
350 Ashland Avenue 
Buffalo, N.Y. 14222 

(716) 834-9425 


D> 


POLY-vu 
#PYII9 


K&M Company 
TORRANCE. CA 90503 


fe) 


o 


-CATALOGO85 
ABSTRACT085 
BYE79 ASM 
BYE79 DOC 


CRCK COM 
CRCKLISTO85 
. SD-44 ASM 
SD-44 COM 
sD-44 DOC 
SQ-16 COM 
SQUEEZ16DOC 
SQUEEZ ERDOC 
U-G-FORMLIB 
USQ-19 COM 


14 file(s). 


CPMUG vol. 85 2/11/86 


42 directory entries remaining. 


D>STAT O: 


Bytes Remaining On O: Ok 


D>TYPE O:-CATALOG.085 


CPMUG VOLUME 085 


DESCRIPTION: 


NUMBER SIZE 


085.1 78K 
085.2 15K 
085.3 48K . 
. 085.4 2K 
085.5 14K 
085.6 16K 
085.7 23K 
085.8 12K 


NAME 


-CATALOG.085 
ABSTRACT. 085 
CRCK .COM 


CRCKLIST.085 


BYE79.ASM 
BYE79.DOC 
SD-44.ASM 
SD-44.COM 
SD-44.DOC 
SQ-16.COM 
SQUEEZ16.DOC 


USQ~-19.COM 


7.9 remote user i/o program 

4.4 super directory program 
SQ 1.6 squeezer program 

1.9 unsqueezer program 


COMMENTS 


CONTENTS OF CP/M VOL. 085 

Abstracts of files on this disk. 

CRC file checking program. 

Type "CRCK *.*" to check CRC's of all files. 
List of CRC's for files on this disk. 


8080 Assembler source code for BYE 7.9 
Documentation for BYE 7.9 

8080 Assembler source code for SD 4.4 
Assembled 085.3 (for those without MAC) 
Documentation for SD 4.4 

8080 object file for SQUEEZE 1.6 
Documentation for SQUEEZE and UNSQUEEZE 
programs. 

8080 object file for UNSQUEEZE 1.9 


This software was obtained from the Hyde Park (Chicago) RCPM system, 
run by Ben Bronson at (312) 955-4493. 


D> 


TYPE O:ABSTRACT.085 
CPMUG Volume 85 Abstracts 


BYE79.ASM and BYE79.DOC 


Ory is the program originally written by Dave Jaffe, formerly of the 

’ Chciago Area Computer Hobbyist Exchange, that allows a "remote" user 
with a modem to access your CP/M microcomputer as if he were sitting 
at the console. It has been extensively revised, modified and improved 
upon over the years and now contains a great many options, such as 
limiting the number of drives available to the user, limiting the 
number of user areas accessible under CP/M version 2+, etc. Plus, 
a transient program (BYE being considered a semi-resident program) 
can modify these restrictions by "hot-patching" the appropriate 
memory locations. More details on BYE's options may be found in 
‘the DOC file and in the comments in the ASM file. 


SD-44.ASM, SD-44.COM and SD-44.DOC 


SD is the most-used Super Directory program for RCPM's. It has many options, 
allowing the user to look at any number of selected drives, all drives, 

a specific user area, all user areas, etc. It allows printing of the 
directory to the CP/M LIST device, writing the directory to a disk 

file (and concatenating additional directories), and more. Of course, 

the directory is sorted into alphabetical order and is printed with 

file sizes. See the DOC file and the comments in the ASM file for more 
information. Digital Research's MAC macro assembler is required for 
assembly. 


a SQUEEZ16.DOC, and USQ-19.COM 
“~ RCPM's use SQ to "squeeze" a file so that it takes up less space on 

disk and so that the remote user will be able to transfer the file in 

a minimum amount of time. This can be critical with long distance callers 
or with heavily used systems. SQ and USQ are written in BDS-C, but the 
source files are not included on this disk, partially due to space 
considerations. I do intend to include the source on a later CP/M UG disk. 
When SQ/USQ were originally written, a file called FLS was included as a 
file list builder for processing wildcard filenames. The latest versions 
of SQ and USQ have wildcard handling capabilities built in, so FLS is 

no longer needed. See the DOC file for more information, including how 

SQ works to squeeze your files. Space savings on disk are often as much 
as 30 to 40 percent. 


Jim Mills, CPMUG Reviewer 


‘D> 


TYPE BYE/-.DUU 
07/25/82: Created file BYE79.DOC mostly from old versions of BYE 
documentation: BYE67.DOC, BYE77.DOC, BYE78DIF.DOC, and 
BYEWARN.DOC. Many comments are by Thom Quick. 
Jim Mills, CP/M UG Reviewer 


@ vote: The major enhancement of version 6.7 of BYE is that a single 
source file now contains conditional assemblies to control 
either PMMI or D C Hayes modem cards. Otherwise, this doc- 
umentation is essentially the same as that for version 6.3, 
with the addition of some minor fixes and improvements. 


BYE67.ASM DOCUMENTATION 


The BYE program for PMMI and D C Hayes modems has undergone three 
significant revisions in recent months, and many features and options 
have been added. This documentation is intended as' a guide for sorting 
through the many additional items. 

Most of the new features have been added via conditional assembly, 
thereby allowing the program to accomodate users with varying memory re- 
quirements. 

Note that not all combinations of conditional assembly have been 
tested, so be careful! 


DOCUMENTATION OF REVISION 6 


The following features have been added to revision 6: 


1) Timed logout- This feature allows your system to disconnect 
after a pre-specified time when there is no input from the remote 
user. 

==> Set "TIMEOUT" to "true". 
==> Set "TOVALUE" to the number of minutes to wait before 
disconnecting. 


This feature requires that timing now be done in software, instead of 
using the PMMI timing circuitry, which is tied up with baud rate gen- 
eration when the system is in use. Therefore, you must set the equate 
"FASTCLK" to true if you are running a 4mhz system, and to false if 
you are using 2Mhz. You must do this even if you don't use the timed 
logout feature. 


2) Autoload~ Setting "COMFILE" to true causes the bye.program to auto- 
matically load and execute a machine language program from the disk. 
This is useful for remote bulletin-board systems, remote query and 
data entry, etc. If you are using cp/m 2.x (equate "CPM2" set true), 
you must specify which user number to load this file from. This is 
done by setting the equate "COMUSR". Note that this user number will 
also be the one under which the autoload program is executed. 


C*) The loaded program can prevent the remote user from re-booting the 

2 system by changing the byte at 0 (jmp instruction) to a call. When 
this is done, the system will trap control-c from the remote user 
(changing the character to a null), and a branch to location 0 (warm- 
boot) will terminate the session, as if "bye" had been typed by the 
user at cp/m command level. This allows the autoload program to end 
the session by merely branching to location 0. 


3) 


4) 


5) 


6) 


if it 1s necesSary to give the user full control of cp/m, tne auto~ 
load program must replace the call at zero with a jump. In this case, 
control-c will no longer be trapped, and "jmp 0" will warm-boot the 
system. 


NOTE: The system operator can answer an incoming phone call in 
either of two ways: 


A>BYE /C ;this form causes the bye program to answer the 
phone, prompt the user for nulls, then load 
and run the autoload program. 


A>BYE /A :this form causes the program to answer the 
phone, then boot to cp/m command level. 


Note that either method will, upon termination of the session, 
re-load the autoload program before accepting another call. 


User and drive number verification- The bye program will now 
validate the logged-in drive, and, if it exceeds the value set 
by the equate, "MAXSDRIVE", the system will reset the logged-in 
drive to 0 and perform a warm~boot. 


If you are using cp/m 2.x ("CPM2" equate set to true), the same 
verification will be done for the logged-in user number. The 
equate in this case is the variable "MAXS$USER", which should be 
set to 0 for cpm 1.x. 


Special function keys~ You can assign any three key-codes on the local 
keyboard for the following special functions (Note that you should also 
select the DUALS$IO mode along with these options): 


"TWITKEY" - This key immediately logs out a user. This can 
be useful to remove system crashers, "explorers", 
etc. from the system. 


"MSGKEY" ~- This key prints the message: "MESSAGE FROM OPERATOR:", 
which can be used to announce operator presence, prior 
to typing a message to the remote user. 


"SYSDKEY" - This key prints the message: "SYSTEM DOWN IN 5 
MINUTES", which is handy when you want to drop a hint 
to a caller who has worn out his welcome. (or just 
when you want to politely get the system back for 
yourself). 


Note that the conditional assembly for these keys is set by the 
equate "FKEYS". The key-codes can be individually changed. 


Decimal user logs - If you use the USRLOG functions (see revision 5 
section of this documentation file), setting the "DECIMAL" equate to 
true provides a decimal printout of the user log values, instead of the 
default hexadecimal printout. 


Lower case checking - By setting the "CK$LWC" equate to true, the user 
will be asked at sign-on if his terminal can display lower case. If 
the user responds with "N", all output will be converted to upper case 
before transmission. 


If you have an IMSAI (or any computer with an input port set by 
switches), setting the "IMSAI" equate to true provides the following 
capablities: 


switch function 
0 turns on the hardcopy log ... this echoes remote 
inout (not outnout!) onto the printer. This provides 


a waracopy ogging funceion Wien Minimas amouNne 
of printout..i.e., only the users' input is echoed. 


1 sets up "password mode"...when this switch is up, any- 
one trying to log onto the system must provide a pass- 
word. This allows you to reserve the system at times 
for special callers. Note that the "PWRQD" equate 

Cw] must be set to true for this key to have any affect. 


2 blacks out the remote user...this is useful when 
you need to enter a password into the machine that 
you'd rather the remote user not see. Characters 
echo onto the local terminal, but are not sent to 
the remote user. Note that the equate "DUALSIO", which 
allows the local terminal to be functional, must be 
set to true for this key to have any effect. 


3 enables the FKEY's, when the "FKEY" equate is set to 
true. Using this switch, the special function keys 
can be used normally when the switch is off, and 
as function keys when the switch is up. 


Also: the user log (if USRLOG is set to true) will be displayed 
on the front panel LED display. 


The port address of the front panel I/O port can be changed using the 
"SENSE" equate. It is initially set up for the IMSAI addressing, which 
is port OFFH. 


8) The console status routine now checks the overrun and framing error 
bits of the PMMI modem chip, and if either of these bits is set, the 
character in the modem is cleared. Thanks to Bruce Ratoff who used 

re] this idea in his DC Hayes version of the bye program. 


9) Since the WELCOME file may reside on a different user number than the 
autoload program (if any), the WELUSR equate has been added to indicate 
the user number under which WELCOME may be found. Note that if the 
COMFILE option is not also used, the caller will receive control of the 
system under user number WELUSR. 


Credits: (version 6.3) 


Dave Hardy, who implemented the special function keys, and IMSAI functions 
for the Technical CBBS, Dearborn, Mich (313~846-6127 24Hr). 


Bruce Ratoff, who provided a lot of this stuff in his DCHBYE54, which I 
lifted and added to the PMMI version. 


Keith Petersen, who provided the ideas and suggestions. 


====>Ron Fowler 
Sept 24, 1980 


Credits: (version 6.7) 


Dave Kozinn, who had the time and patience to merge the D C Hayes code 
into PMMIBY63, creating (at long last) an "universal" BYE. 


re) ===>>Bruce Ratoff 
Feb 17, 1981 


DOCUMENTATION OF REVISION 5 


PMMIBYE5.DOC (as of 7/20/80) 


The PMMIBYES.ASM program 1S out for distribution, but 1t nas not veen 
thoroughly tested in all of the possible modes of operation. 

(Please note that version 5.4 is substantially longer than previous 
PMMIBYE versions. Because of the great number of conditional switches, the 
program could require as many as 1060 bytes of RAM, or it could be smaller 
than the 900 bytes used by the original PMMIBYE. It all depends on the way 
you set it up.) 


Basically, several new conditional assembly routines have been added to 
allow user selection at time of assembly of the following: 
1. Password access 
2. User log (counts number of system callers) 
3. Memory-mapped console I/O 
Also added to V5.4: 
1. 710 Baud option for PMMI modem 
2. Modifications to AUTO-ANSWER routines 
3. "/R" option to allow reset of user log counters 


Password access was made conditional to allow use with systems that offer 
unrestricted access. 

The user log was added to allow the system operators to keep track of the 
number of people who called the system. In addition, it can also count the 
number of unsuccessful log-ons (i.e. didn't know password) and the number of 
voice calls, and conditionally display both numbers on the system console 
when the program is exited with a control-C from the system console. The 
counters can be initialized with the "/R" option to all zeroes, or preset by 
using DDT, or SID. The number of successful log-ons is also conditionally 
output to port 255 (OFFH) for display on the computer's front panel. 

The memory-mapped I/O conditionals have been added to allow use of the 
serial I/O port on the Morrow's 2D controller board as the system console; 
however, the routines can be used with any memory-mapped system. 

The 710 Baud option was added for "short-haul" callers, and because 

qe at 710 Baud with the PMMI modem is "iffy" at best, it will 
probably be of very little use. 

The AUTO-ANSWER routines were modified to allow more dependable ringback 
operation. Unfortunately, the ringing signal at the caller's end of the 
phone line does not always correspond exactly with the ringing signal at the 
system's end. Although a system-end ring does occur sometime during the 
caller's ring cycle (ring-no ring), it is possible for the system to receive 
no or 2 rings in the time that the caller thinks just one ring has occurred 
(The DIAL program is notorious for this). The solution chosen for this 
problem was to check for one or two rings before call-back. This would 
allow for the "phase" difference of the caller-system ring signals. This 
solution also means that the phone must ring at least three times before the 
system will assume that the call is voice, and is not to be answered. The 
advantage of this arrangement is that it is virtually impossible for the 
computer to "miss" a call that is intended for it. 


Dave Hardy 


BYE77.ASM DOC 


BYE77.ASM incorporate into one version the features made available 
in Vers 76,76B and adds equates for the Western Digital 8250 Async 
Comm Element. This should make the BYE program compatible with 
most 280, 8080A, and 8085 systems that use INTEL 8251 or WD8250 
USART/ACE programable communications devices. 


CRC'S for the files are: 


BYE76.ASM ORIGINAL INPUT 80 E2 
BYE77.ASM ORIGINAL 4D 52 


PLoal fake Jer IRIGINAL SQ CE BA 


BYE77.DIF 1E 00 
BYE77.DOQF 31 4B 
BYE77.ASM SSED OUTPUT 74 C8 


Thom Quick, 312-887-5406 (w) 


BYE78DIF.DOC 
Paul Traina has provided us with BYE78.ASM. In order to take advantage 
of DIF/SSED I have created two dif files that should make conversion 
Or upgrade to this SUPER version easier. The two dif files are: 

1) BYE76/78.DIF 

2) BYE77/78.DIF 
It should be noted that if the base input file was created with DIF.com; 
then to arrive at an original equivilent (crck's equal) of bye78.asm, 
you will have to use DU.COM to locate the last block of the last extent, 
and pad/fill it with " 1A1AIAIAIAIA.... " . 


I have tried this and it works. Relevant crck'c are: 


BYE76.ASM ORIGINAL INPUT 80 E2 
BYE77.ASM ORIGINAL INPUT 4D 52 
BYE77.DIF 1E 00 
BYE76/78.DIF 8A AG 
BYE77/78.DIF 80 45 
BYE78.AQM ORIGINAL 5B DB 
BYE78.ASM ORIGINAL E6 56 
BYE78.ASD BYE76/78 & BYE77/78.DIF 

SSED DERIVED AQ F5 


(Note the use of the "D" in the extent of the derived .ASM file 
it would be nice if we could have an exchange standard to 
identify original vs derived files.) 


Thom Quick 312-887-2334 (w) 0800-1730 CST 


The Bye programs have a note that I included on the polarity 
of the jump instructions after an IN from a port. IF problems 
exist in the execution of the program, you should confirm that 
the logic for your particular UART/USART/ACE is correctly 
reflected. For example in the ringwt routine: 


RINGW2 EQU $+OFFSET 
IN RPORT ;GET THE STATUS 
ANI P2RDET ;RINGING? 
JZ RINGWT ;NO, WAIT 


THE 'JZ' MAY BE REPLACED WITH A 'JNZ' TO REFLECT THE USART/ACE 
IMPLEMENTATION. 


uneck your system documentation to aetermine tne correct 
logic. Again this applies only to conditional jumps or 
Calls after an ' IN ' froma port... 


Thom Quick 


BYE79.ASM notes,CP/M UG Vol. 85 (07/25/82): 


Various files referred to in the above documentation do not appear 

on CP/M UG volume 85. These are mostly older versions -- or .DIF 
(difference) files meant for use with the DIF and SSED utilities 

which allow upgrading to a new version from an old "known" version 

of the file. Studying the comments and equates at the beginning of 
the BYE79.ASM file, and after the beginning of the "relocated code" 
will be of great benefit in understanding this program, and how it may 
be made to interact with other programs. 


Jim Mills, CP/M UG Reviewer 
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47431 i4% DoD-aa.D0C created from the rollowing files: 
SD-41.DOC, SD-42DIF.DOC, SD~43.DOC. 


The SD Directory Program 


This documentation file concerns SD-NEW.ASM and SD-NEW.OBJ, 
version 4.1 as of October 20, 1981. Version 4.1 is a 
significant upgrade of the standard "super-directory" program 
that most RCP/M systems are now using as their "DIR" executor. 
SD-41 implements many new features over version 3, and has been 
tested on a wide variety of CP/M systems prior to release. 
However, due to the large number of equates in the source file, 
all possible permutations have NOT been tested, and it should be 
understood that revision 4.1 is experimental in nature, and 
should not be placed on-line in remote applications until 
sufficient time has elapsed to allow for initial bug reports 
from the field. 


The most significant difference between version 4.1 and 
version 3.X concerns the ability of SD to search a range of 
drives and/or user areas for a specified file. This capability 
is patterned after FILEFIND, but is significantly more useful in 
that SD will report the sizes of files matched. A new BDOS 
intercept routine has been added, which although more involved 
than the FILEFIND method, is more generally applicable and 
should run "as-is" on most CP/M systems. Thus, by using SD-41, 
the use of a separate FILEFIND program should be unnecessary. 


°o The basic operation of SD is as in previous releases. You 
merely type "SD", followed by an optional ambiguous or 
unambiguous filename (as you would with the CCP directory 
command). Omitting the filename (i.e., "SD [CR]"), will be 
interpreted as "SD *.*", Similarly, "SD A:" would imply "SD 
A:*.*" and "SD B:" would imply "SD B:*.*". In addition to the 
filename option, up to 8 command line options may be specified. 
If options are to be specified, then the filename must be 
EXPLICITLY specified by at least a drive code. Option fields 
are preceded by a single dollar sign as with most Digital 
Research programs such as MAC, and may be essentially free-form 
in format. Example: SD A: $s a D rn u0 fp. Note that the 
reference to the A drives in "A:" is mandatory. Invoking SD 
with a command of the form "SD $s a D rn u0 fp" would result in 
SD thinking that $S was the file to be searched for. Note also 
that spaces and case within the option field are insignificant 
(i.e., "$ SADrNuOF p" is equivalent to "$ S ADRN UO F P"), 
The only exception concerns the "USER" option which will be 
explained later. Users should also be aware of two restrictions 
on the command line format. SD scans the entire command line 
for a dollar sign preceded by at least 1 blank to delimit the 
beginning of the option field. For this reason, invoking SD 
with a command line such as "SD $ SAR" is illegal since SD will 
consider the first dollar sign to be the option field delimiter. 
If you need to specify a a filename whose first character is a 

Q@ dollar sign, precede it with a drive code as in "SD A:$ SAR", 
In this instance, SD will consider the first dollar sign 
insignificant as it is not preceded by a blank. 
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The second restriction is that command line options may be 

QO specified once and only once per invocation. That is, "SD A: 

$SDS" would be illegal since the "S" option is specified twice. 

This shortcoming is due to the fact that options can be made 
into defaults at assembly time. 


The eight options recognized are: 


"Ss" — system option : system files will be included in 
the output rather than being suppressed. 


"FR" — file option : the directory output will be 
echoed to a disk file named "SD.DIR" on the 
DEFAULT drive. If SD.DIR already exists, then 
the directory output will be APPENDED to the end 
of the file. Otherwise, SD.DIR will be created 
as a new file. The append feature allows you to 
build up one massive file on the default drive 
containing the directories of all of your disks, 
without having to concantenate a swarm of 
individual directory files. If you plan to use 
this feature often, it willbe simpler for you to 
have a dedicated version on your MASTCAT disk 
with RESFLG set TRUE. The advantage of this is 
that you can work through a pile of disks 
without having to CTRL-C or specify the "R" 
option everytime you SD a new disk. Failing to 

°o do this will result in the allocation vector 
being invalid, and FREE size will be wrong. 


"U" - user option : allows the specification of the 
user number for the directory of the form "Uxx" 
where the user # is greater than 0, but not 
greater than a specified value not to exceed 15. 
The user option specification will be illegal if 
the user # is out of range, omitted, or if U is 
specified on a pre-CP/M 2 system. Note that 
since the user option requires a parameter 
(i.e., the user number), the user number must 
immediately follow the "U" option on the command 
field. That is, "U1" is legal, but "U 1" is 
not. In this respect, the U option differs from 
the other options in that embedded spaces ARE 
significant. 


"A" - all users : causes SD to display directories of 
all user areas starting at the user area 
specified in the U option or, if U option is 
omitted, the default user area and continuing up 
to MAXUSR. 


"R" - reset option : allows for automatic resetting of 

oO the disk prior to performing directory search so 
that the allocation vector will be updated. 

Same as doing a CTRL-C when changing disks, but 

handy if you didn't (such as when running a 
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SUBMIT file). Note that the RESFLG equate will 
force the R option unconditionally each time SD 
is run. Useful for SDing a stack of disks with 
the "F" option, but slows down SD considerably 
in normal use. 


"N" - no page option : unconditionally disables the 
page pause option. Useful when running SD in 
the "F" and/or "A" modes when you don't want the 
page prompt slowing you down. Note that SD-41 
will not put the page-pause prompt into. the 
output file. 


"p" — printer option : forces all console output to be 
echoed to the CP/M list device, with the most 
significant bit set to 0. 


"D" - all disk option : allows SD to search all disk 
drives on-line starting with the disk drive 
specified or implied with the command line 
filename. For example, "SD B: $D" will result 
in SD searching all drives beginning with drive 
B. "SD *.* $D" will result in SD searching all 
drives beginning with the drive that is logged 
in. 


If an unrecognized option (or illegal user option 
specification) is detected, then the command line will be played 
back to the console up to the point where the error was 
detected. However, if the REPERR option is disabled, then SD 
will keep its mouth shut and ignore everything on the command 
line past the illegal field. In this situation, an illegally 
specified user number would default back to the current user 
number. The option of DISABLING error reporting was included 
primarily for systems with hidden doors and secret passageways. 
Shooting off rockets and clanging bells everytime a holswap 
starts "experimenting" just calls attention to the fact that 
there really IS something behind that hollow- sounding wall 
after all (if you get my drift). 


As an added convenience, it is possible to "hard-wire" some 
Or all of the command line options. For example, if you want SD 
to ALWAYS perform a reset of the disk system before putting its 
show on the road, you can do just that. For details, see the 
comments preceding the option field lookup table in the 
assembler source file. 


Finally, if the all-disk and/or all-user options are 
enabled, it may be desirable to restrict searches. To 
facilitate this, a table is included in SD (beginning at label 
"LODRV" and continuing through "HIDRV"). The table consists of 
a single byte for each drive to be searched beginning with A. 
Each byte may be in the range of 0-15 mod 15 and defines’ the 
highest user number that SD will search for that particular 
drive. The highest drive number to search is defined by the 
length of the table. If four DBs are present between LODRV and 
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HIDRV, then drives A-D can be searched. The source file 
includes the LODRV-HIDRV table in its maximum configuration for 
16 drives. However, it is recommended that you delete DBs 
referencing drives that aren't available on your’ system. 
Although SD will intercept attempts to search non-existant 
drives, there really isn't any point in allowing SD to always 
search drive C when you only have 2 logical drives; and 
depending on how your BIOS is constructed and how long it 
monkeys around before advising the BDOS of the select error, it 
could save some time. 


A THOUGHT FROM "THE LAST REVISOR" 


If you sit down and figure out the number of permutations 
of options and equates in the latest versions of SD, you'll 
understand why there aren't any warranties as to the absence of 
entomological cybernoids. I leave it to the CP/M community to 
smoke out what bugs may pop-up when a certain combination of 
variables occurs. If you find any bugs, please leave an 
advisory or a fix on either TCBBS or the Hyde Park RCP/M so that 
they can be exterminated. 


Finally, my latest revisions expanded the size of the load 
module considerably, and it is now weighing in at just under 2K 
if all of the options are enabled. A program of this type has a 
tendency to be widely propogated throughout a disk library, and 
since 2K is the block size of most double and quad-density 
systems, I feel that it is important to try and keep SD under 2K 
if at all possible. That's why some of my code may be cryptic 
in some places - I've sacrified clarity for code reductions. If 
you plan to make public-domain enhancements to SD which would 
push it over the 2K mark, ask yourself whether its worth tying 
up an additional disk block. This is also an invitation for 
someone less lazy than myself to further optimize the code to 
reduce SD to as compact a package as possible (thus making room 
for more enhancements). For my part, I quit when I got it under 
mei It works, it fits and I'm ready to move onto something 
else. 


I pass the torch. 


David Boruff 
Knoxville, Tennessee 
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SD-42.DIF is the file produced by using DIF.COM on an update 
of SD-41. Distributing the update this way rather than as 

a full ASM file is an experiment. If it works, DIF and 

SSED are going to be the way most updates are distributed 

on the RCPM network. As of 11/02, you should be using 

DIF v1.00 (crc=B9 C6) and SSED v1.01 (CRC=89 C9). 


If you have SD-41.ASM, it will be updated automatically 
with SSED.COM using the following command (pay attention 
to the space in front of the ">") 


AO>SSED SD-41.ASM <SD-42.DIF >SD-42.ASM 


The unsqueezed SD-42.DIF should have a CRC of FD 23. The 
previously distributed SD-41.AQM and ASM have CRCs of 87 83 
and B4 89. The SD-42.ASM produced by SSED should have a 
CRC of FB 55. That SD-42 has been carefully compared with 
the original SD42 and tested after assembly. It seems to 
work well. 


(SD-42 is Chuck Forsberg's update of David Boruff's SD-41l. 
This DIF file & comment are by Ben Bronson) 

SD-4.3 - 06 feb 1982 

R.B. Strand 


SD-4.x uses the questionable method of modifying the trap table 
in BDOS to disable the normal BDOS error messages. This allows 
the identification of invalid drives and bad disks by SD. 
However, earlier versions did this modifying without testing 
whether or not the vector pointer at BASE+5 was virgin, or had 
been changed by DDT, UNSPOOL or the like. This created great 
confusion (and system crashes). To alleviate the problem, SD now 
checks whether the pointer is valid (L-reg = 6) before swapping 
the BDOS trap vectors, and also only swaps them when the all-disk 
search option is requested ($D). 


Additional changes include the addition of dim (vs. reverse) 
characters for the ADM-31 and similar CRTs. These are merely 
substituted for the reverse characters. Also, when using RMAC, 
there is no requirement for external defs of BASE, etc. Instead, 
merely add an ASEG statement and compile as if with MAC. MAC 
users should ignore the "B" error flag for this statement. 
Flipping on the RMAC flag now still requires linking the 
externals. 


07/25/82: Some of the files referred to in the above documentation 
are not present on this disk (CP/M UG 85) as they are mostly 
incorporated into SD-44.ASM. Most of the files I refer to are 
-DIF (difference) files for use with DIF and SSED which allow 

one to create updated files from "known" older files. 


O> 
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+PBE SQUBEZ.».DUC 
USAGE AND RECOMPILATION DOCUMENTATION FOR: 7/18/81 
SQ.COM 1.6 File squeezer 
USQ. COM 1.9 File unsqueezer 
FLS.COM 1.1 Ambiguous file name expander 


note (07/16/82): FLS.COM is now unnecessary. With versions 
1.6 and 1.9 of SQ and USQ, respectively, a multi-file handling 
capability is built-in to both SQ and USQ. 


DISTRIBUTION RIGHTS: 

I allow unrestricted non-profit distribution of this 
software and invite users groups to spread it around. 
However, any distribution for profit requires my permission 
in advance. This applies only to the above listed programs 
and their program source and documentation files. I do sell 
other software. 


PURPOSE: 
The file squeezer, SQ, compresses files into a more compact 
form. This provides: 
1. Faster transmission by modem. 
2. Fewer diskettes to distribute a program package. 
(Include USQ.COM and instructions, both unsqueezed.) 
3. Fewer diskettes for archival storage. 


Any file can be squeezed, but program source files and text 
files benefit the most, typically shrinking by 35%. Files 
containing only a limited character set, such as dictionary 
files, may shrink as much as 48%. Squeezed files look like 
gibbersh and must be unsqueezed before they can be used. 


ee unsqueezer, USQ, expands squeezed files into exact 

duplicates of the original or provides a quick, unsqueezed 
Gisplay of the tops of (or all of) squeezed files. 
Unsqueezing requires only a single pass. 


Both SQ and USQ accept batches of work specified by lists of 
file names (with drives if needed) and miscellaneous 
options. They accept these parameters in any of three ways: 


1. On the CP/M command line. 
2. From the console keyboard. 
3. From a file. 


FLS.COM NO LONGER NEEDED 


The FLS program can be used (on the same command line!) to 
expand parameter lists containing wild-card (ambiguous) file 
pours into lists with the specific file names required by SQ 
and USQ. 


VVVVVV 


This combination of programs allows you to issue a single 
command which will produce many squeezed or unsqueezed files 
from and to various diskettes. For example, to unsqueeze all 
squeezed ASM files on drive B and send the results to drive 
C and also unsqueeze all squeezed TXT files on drive A_ and 
send the results to drive D: 

C«] A>fls c: b:*.aqm d: *.tqt lusq 


---> AdDusq c: b:*.agqm d: *.tqt <---- vers. 1.9 does same thing 
as if FLS had been used 


For detailed instructions see USAGE. 
This DOES run under plain old vanilla CP/M! Many of the 
smarts are buried in the COM files in the form of library 


routineS provigeaq Wl NH '1t& bw « Parvnayge VQ01a . ®VE fe > ee 
Lifeboat). 


The above example simulates a "pipe" (indicated by the "[") 
by sending the "console" output of the fls.com program to a 
temporary file and then running the sq.com program with 
options which cause it to read its parameters from its 
"console" input, which is really redirected to come from the 


temporary file. 


THEORY: 
The data in the file is treated at the byte level rather 


then the word level, and can contain absolutely anything. 
The compression is in two stages: first repeated byte values 
are compressed and then a Huffman code is dynamically 
generated to match the properties of each particular file. 
This requires two passes over the source data. 


The decoding table is included in the squeezed file, so 
squeezing short files can actually lengthen them. Fixed 
decoding tables are not used because English and various 
computer languages vary greatly as to upper and lower case 
proportions and use of special characters. Much of the 
savings comes from not assigning codes to unused byte 
values. 


More detailed comments are included in the source files. 


USAGE TUTORIAL: 

As usual, you have to learn how to tell the programs what to 

do (i.e., what parameters to type after the program name). 

First I will introduce the various possibilities by example. 
on: I will summarize the rules. 


In the simplest case either SQ or USQ can simply be given 
one or more file names (with or without drive names): 
A>sq xyz.asm 
; A>sq thisfile.doc b:thatfile.doc 
will create squeezed files xyz.agqm, thisfile.dqce and 
thatfile.dgc, all on the current drive, A. The original 
files are not disturbed. Note that the names of the squeezed 
files are generated by rules - you don't specify them. 


Likewise, 

A>usq xyz.aqm 
will create file xyz.asm on the A drive, overwriting the 
Original. (The original name is recreated from information 
stored in the squeezed version.) The squeezed version is not 
disturbed. 


Each file name is processed in order, and you can list all 
the files you can fit in a command. The file names given to 
SQ and USQ must be specific. You will learn below how to use 
the FLS program to expand patterns like *.asm (all files of 
ce ay into a list of specific names and feed them into 


The above examples let the destination drive default to the 
current logged drive, which was shown in the prompt to be A. 
You can change the destination drive as often as you like in 
the parameter list. For example, 
‘ A>sq x.asm b: y.asm z.asm ¢c: d:s.asm 

will create x.aqm on the current drive, A, y.aqm and z.aqm 
on the B drive and s.aqm on the C drive. Note that the first 
three originals are on drive A and the last one is on drive 
D. Remember that each oarameter is »nrocessed in order,e so 


you must change t.ie destination aurive »oeLrore you speciry -ne 
files to be created on that drive. 


Eventually you will have diskettes with many squeezed files 
on them and you will wonder what is in which file. If they 
weren't squeezed you would use the TYPE command to look at 
the comments at the beginning of the files. But squeezed 
@ files just make a mess on your CRT screen when you TYPE 

them, so I have provided the required feature as a preview 
option to the USQ program. 

A>usq -10 x.bas bsy.asm 
will not take the time to create unsqueezed files. Instead 
it will unsqueeze the first 10 lines of each file and 
display them on your console. The display from each file 
consists of the file names, the data and a formfeed (FF). 
Also, 

A>usq - c:xyz.mac 
will unsqueeze and display the first 65,535 lines of any 
files listed. That's the biggest number you can give it, and 
is intended to display the whole file. 


This preview option also ensures that the data is 
displayable. The parity bit is stripped off (some Wordstar 
files use it for format control) and any unusual control 
characters are converted to periods. You'll see some of 
these at the end of the files as the CP/M end of file is 
treated as data and the remainder of the sector is 
displayed. 


You are now familiar with all of the operational parameters 
of SQ and USQ. But so far you have always typed them on the 
command line which caused the program to be run. For reasons 
which will become apparent later, I have also provided an 
interactive mode. If there are no parameters (except 
directed i/o parameters, described later) on the command 
line, SQ and USQ will prompt with an asterisk and accept 
parameters from the console keyboard. Each parameter must be 
followed by RETURN and will be processed immediately. An 
empty command (just RETURN) will cause the program to exit 
back to CP/M. Try it - it will help you understand what 
follows. 


Now lets get into directed i/o, which will be new to most of 
you, but will save you so much work you will wonder how you 
ever got along without it. 


Perhaps you frequently squeeze or unsqueeze the same list of 
files and you would like to type the list once and be done 
with it. Use an editor (or FLS, described below) to create a 
file with one parameter per line. For example call it 
commands.1st. 


Then, 

A>sq <commands.l1st 

will cause the command list file to be read as if you were 
typing it! You will see it on the console. 


That was redirected console input. Now assume that you have 
a very long list of files to squeeze or unsqueeze and while 
you are taking a nap the progress comments and maybe some 
error comments scroll off the screen. Redirecting the 
console output will let you capture the progress 
information in a file so you can check it later. The error 
comments will have the screen to themselves. 


For example, 


A-Sq <commands.1St rout 

will send the progress comments to the file "out", which you 
can TYPE later. The routine display of the program name and 
version, etc., will still go to the console. 


A more practical example is to send that information to the 
console and to the file. 

oO A>sq <commands.Ist +out 
will do that. 


Redirected input and output are independent - you can do 
either, both or neither. 


There is one more form of redirection called a "pipe". It is 
by far the most important to you. Recall that I promised to 
tell you how to use ambiguous file names such as *.asm (all 
files of type asm on the current default drive) or *.?q? 
(all files having a "q" as the second letter of their type). 
That last example just happens to mean "all squeezed files", 
assuming you don't have any other files with such a_ silly 
name (I hope). 


I have provided a program called FLS which is intended 
primarily for use in pipes. Here is an example: 

A>fls c: x.asm y*.asm >temp. $$$ 

will simply pass the first two parameters through to the 
console output, which is being redirected to a file called 
temp.$$$. But the third parameter will be replaced by all 
the files on the current drive which are of type asm and 
have names beginning with y. 


FLS is smart enough to know that a letter followed by a 
colon and nothing else is a destination drive name intended 
Oo: SQ or USQ. It will also treat any parameter beginning 
with a - (minus sign) as an option to be passed through. 
Anything else is considered a file name or pattern and is 
checked against the directory of the appropriate drive. 


Therefore you could use: 

A>fls b: c:*.aqm *.aqm -10 stuff.dqc >temp. $$$ 

A>usq <temp. $$$ 

A>era temp. $$$ 

to unsqueeze all files of type aqm on drives C and A and put 
the unsqueezed files on drive B, and then preview the first 
10 lines of file stuff.dqc. 


Here is where the pipe comes in. The above three commands 
can be abbreviated as: 
A>fls b: c:*.aqm *.aqm -10 stuff.dqc lusq 


That little "{" is the pipe option and it causes the FLS 
output to be redirected to a temporary file and when that is 
done it actually runs USQ for you with the proper input 
redirection and then erases the temporary file. 


If _that isn't enough, you can still use the + or > 
redirection option at the end of that line to capture the 
console output from USQ. 

Qs b: c:*.aqm *.aqm -10 stuff.dqce lusq >out 


If you plan your comments carefully you can produce a single 
file containing an abstract of an entire library of squeezed 
files in one step! 

A>fls -25 *.?q? lusq >abstract 


One final point. Anywhere you soecify a file name vou can 


Specify a drive in front Of it. That applies to redirection 
and well as files to be squeezed and unsqueezed. If a name 
begins with a - (minus sign) it will look like an option to 
FLS unless you put a drive name in front of it (b:-sq.077). 


USAGE SUMMARY: 

The previous section gradually presented the various options 
by example. This section gives a condensed and more abstract 
description and is intended for reference. If you couldn't 
see the forest for the trees, maybe this will give you a 
better view. 


The parameter handling of these programs is straightforward. 

Parameters fall into two classes: directed i/o options and 

operational parameters . Note that parameters read from files 
or from the console are not forced to upper case, but the 

internal file handling routines all treat lower case as 

upper case. 


When a file to be written already exists, it is quietly 
overwritten. 


Directed I/O parameters: 

The first action taken by these programs is to process 
directed i/o parameters from the CP/M command line. These 
parameters are optional and take the forms: 


<file read console input from file 
>file send most console output to file 
+file send most console output to file and console 
+) Ipgm ... send most console output to a temporary file 
then run PGM.COM and take console input 


from the temporary file. "..." represent the 
parameters for PGM. This is called "piping". 


Only one input and one output redirection can apply to each 
program. After the program has arranged for any directed i/o 
parameters to be obeyed they are deleted from the parameter 
list seen by the rest of the program. 


Operational parameters: 

The program then checks if there are any remaining 
parameters from the CP/M command line. If there are, they 
are obeyed. If and only if there are no remaining parameters 
on the command line, the program prompts for them at the 
console. If console input has been directed to a file one 
parameter is read and obeyed from each line of the file. 
Otherwise, the user follows each typed parameter with a 
RETURN and an empty command exits the program. 


Each operational parameter is obeyed without looking ahead 
to other parameters, so options should precede the file 
names to which they apply. 


SQ operational parameters are a list of the following types: 
: drive: set the current destination drive 
oO filename file to be squeezed 
drive:filename " ® n " 


SQ does not change the files being squeezed. New, squeezed 

files are created on the destination drive (defaults to the 
current drive) with names derived from the original name but 
with the second letter of the file type (extention) changed 
to A, When there is no t.e, OOO is used. The oriaqinal name 


iS saveag in tae squeezea file. 


USQ operational parameters are a list of the following 


types: 
drive: set the current destination drive 
filename file to be squeezed 
drive:filename " ” is ~ 
Oo -count Preview (display on the console) the first 
"count" lines of each file, where 


"count" is a number from 1 to 65535. 


If the -count option IS NOT in effect then USQ creates 
unsqueezed versions of the listed files on the destination 
drive, which defaults to the current logged drive. Each 
unsqueezed file is CRC checked against the CRC value of the 
original file, which is part of the squeezed file. 


The -count option is for previewing squeezed files. It 
allows you to skim through a group of squeezed files, 
peeking at the first "count" lines in each. The > or + 
output redirection option could be used to capture this 
information ina file, along with the corresponding file 
names, thus forming an abstract of the files on a disk. 


When the -count option is used the CRC check is cancelled 
and the output is forced into printable form by stripping 
the parity bit and changing most unprintable characters to 
periods. The exceptions are CR, LF, TAB and FF. The output 
from each file is terminated by an FF. PIP can be used to 
strip FFs and provide formatted printing if desired. "Count" 
defaults to the maximum value, 65,535, in case you want to 
look at a whole file. 


Ors operational parameters: FLS is a "filter", which means 
it accepts input from the console input or command line and 
transforms the input according to a set of rules to produce 
console output. That's fine for getting familiar with FLS, 
but to make it useful you "pipe" its output to the input of 
SQ or USQ. 


Any FLS parameter which is of the form: 
drive: 

or ~anything 

is copied to console output unchanged. 


Any other FLS operational parameter is treated as a file 
name and is checked against the directory of the appropriate 
drive. If it contains * or ? it is replaced by a list of all 
the files which fit the pattern. If nothing is found in the 
directory an error comment is sent to the console, even if 
normal console output has been redirected to a file. 


IMPORTANT: when using a pipe from FLS or any other input 
redirection to get the file list, etc., on which USQ or SQ 
are to operate you must NOT put any parameters other’ than 
redirection following the program name. They must be al] 
together in the input parameter list. Example: 


A>fls -10 b:*.cq lusq +saveout 

wis the proper way to preview the top (first 10 lines) of 
each squeezed .C file on the B drive. The -10 is passed 
through FLS to USQ. The results will be displayed on the 
console and saved in file "saveout" on the A drive. The 
saveout file lets you confirm the list of processed files 
even if the display scrolls off the screen while running 
unattended. 


In summary, i/o redirection parameters (those prefixed by +, 
<p, >, or 1) always follow the command to which they apply, 
but operational parameters (destination drive, -options) 
must be with the file name list. 


EXAMPLES: 
1. Unsqueeze all squeezed files on the current drive and put 
the resulting unsqueezed files on the same drive. 

A>fls *.?q? lusq 


2. Look at the first 10 lines of every squeezed file on 
drive B. 

A>fls -10 b:*.?Q? lusq 
note that since the file names for USQ came from FLS, the 
count option had to come from there too. 


4. Squeeze all .ASM files on the B and C drives and put the 
squeezed files on the D drive. 

A>fls d: b:*.asm c:*.asm Isq 
Note that if d: had not been first the squeezed files would 
have gone to the A drive. 


5. Squeeze file xyz.c on the A drive and put the results on 
the A drive. 
A>sq xyz.c 


6. Build a parameter list of all ASM files on drive C in 
file XX.PAR and view it on the console. 
A>fls c:*.asm +xx.par 


7. Use the above list to squeeze the files to the A drive. 
+) A>sq <xx.par 


8. As above, but results to the B drive. 
A>b: 
B>a:sq <a:xx.par 


9. Squeeze all ASM and C files on the A drive and put the 
results on the B drive. Capture the progress comments in the 
file "out" without displaying them. 

A>fls b: *.asm *.c Isq >out 


10. Preview the first 24 lines of each squeezed ASM file 
THEN unsqueeze them (unless stopped via cnt1-C). 

A>fls -24 *.aqm a: *.aqm lusq 
Note that specification of a destination drive cancels 
previewing. 


RECOMPILATION: 

These programs are written in C and the instructions are for 
the BDS C compiler. The libraries must have been adapted for 
directed i/o as described in DIO2.C. 


The procedures below indicate the various C language source 
files (file type .C) required to recompile. Those files 
contain #include statements which cause header files (file 
type .H) to be read and compiled. The BDSCIO.H header file 

r+) contains information about your system, including how much 
Space to reserve for file buffers. You should use your own 
version of this file. 


The source files DIO2.C, SQDIO.C and USQDIO.C are identical! 
If you only get one, just use PIP to create the rest. They 
are separate only to provide separate CRL files, which are 
needed because of the different external variable options. 


wO 1 «slGe 1ey Qo no: 1ne.tude a.. “1e heacer ba SS ¢ 
therefore the other source files must include the dio 
related headers first. 


DIO.C is supplied with BDS C. The above three files differ 
from the official version only by a change to the dioflush 
function to ensure TEMPIN.$$$ is deleted before another file 

Sp is renamed to that name. (CP/M is stupid enough to make two 
files of the same name!). 


The procedure for building the SQ.COM and USQ.COM files from 
their source files follows. Note that I have renamed the 
first phase of the BDS C compiler to CC.COM. Also I_ will 
assume the BDS C package is on drive D and the SQ and USQ 
related files are on B along with BDSCIO.H and DIO.H. 


Each CC command produces a CRL file with specific addresses 
for external variables. If you recompile a file with the 
same value in the -e option you don't have to recompile the 
other files, just do the desired CC and then repeat the 
entire CLINK. 


CLINK's -s option prints statistics. Top of memory means the 
current TPA. Stack space is what's left over. These programs 
require stack space for local variables, including some 
healthy i/o buffers. Also some functions are recursive. If 
SQ doesn't have several K of stack space it will probably go 
crazy and do almost anything. 


For SQ (note not all use -o): 
D>cc b:sq.c -o -e3200 

D>cc b:sqdio.c -e3200 

D>cc b:trl.c -o -e3200 

D>cc b:tr2.c -o -e3200 

D>ce b:io.c -o ~e3200 

D>clink b:sg sqdio tr2 trl io -s 


The linker will display some statistics. Check that the last 
code address is less than the start address of the external 
variables (3200 in this example). If not, repeat the above 
with a higher address in the -e options. 


For USQ (note: -e2800 may be enough. Note not all use -o): 
D>cc b:usq.c -o -e2900 

D>cc b:usqdio.c -e2900 

D>cc brutr.c -o -e2900 

D>clink b:usq usqdio utr -s 


Check the addresses as described above. 


For FLS: Dick Greenlaw 

D>cc b:fls.c _ 251 Colony Ct. 

D>cc b:dio2.c Gahanna, Ohio 43230 

D>clink b:fls dio2 614-475-0172 weekends and evenings 


a eet eee eee ademas dian ee cami eneendiee dean emee ee 


IN CASE OF TROUBLE: 
I welcome suggestions and bug reports, but you must 
understand that some of the ideas I get would involve almost 
. as much program development as the original package. I have 
um what I want and (I hope) what most users want, so I am _ not 
motivated to spend many more months creating something 
entirely different which just happens to involve data 
compression. The data compression routines are probably less 
than half of this package, and are designed to operate on 
large blocks of data, such as files. 


POLY-vu 
#PV149 


K&M Company 
TORRANCE, CA 90503 


er) 


-CUG-CATOO1 

-CUG-CATOO2 
-CUG-CATOO3 
-CUG-CATQO04 
~CUG-CATOO5 
-CUG-CATOOS 
-CUG-CATOO7 
-CUG-CATOO8 
-CUG-CATOOS 
-CuUG-CATO10 
-CUG-CATO11 

~CUG-CATO12 
-CUG-CATO13 
-CUG-CATO14 
-CUG-CATO15 
-CUG-CATO16 
-CUG-CATO17 
-CUG-CATO18 
-CUG-CATO19 
-CUG-CATO20 
-CUG-CATO21 

-CUG-CATO22 


More.. 
-CUG-CATO23 
-CUG-CATO024 
-CUG-CATO25 
-CUG-CATO26 
-CUG-CATO027 
-CUG-CATO28 
-CUG-CATO29 
-CUG-CATO30 
-CUG-CATO31 
-CUG-CATALL 
CATFORM 
CUGINDEX 
CUGINDEXBAK 
D COM 
PIP COM 
PRCINDEXSUB 
88 file(s). 


CUG vol.O (DIR) 


(xosn #) 


23 directory entries remaining. 


A>STAT 0: 


Bytes Remaining On O: 


A> 


76k 


2/12/85 


TYPE CUGINDEX 
CP/M Users Group — NorthWest 


C USERS GROUP LIBRARY INDEX 


Vol Name Contents 
01 SMALL-C COMP 1.0 Small—-C compiler, version 1.0 
02 SMALL-C COMP 2.0 Small!t-C compiler, version 2.0 
03 GAMES 1 Life, Jotto, Mastermind, Rally, Tic-tac-toe, Yahtzee 
04 UTILITIES 1 Disk util, directory, KWIC, file compare, compress 
05 UTILITIES 2 Word processor, file contat, compare, search, tabify 
06 FUNCTIONS 2 BIOS tinkering, I/O redirection, string- bit-manip 
G7 ‘FUNCTIONS 1 Long integer, floating-point, trig, redir I/O 
08 FUNCTIONS 3 Log, trig, floating-point 
O09 UTILITIES 3 (YAM) YAM (Yet Annother Modem) and utilities 
10 UTILITIES 4 More Utilities 
41 UTILITIES 5 Disk analysis, Disk Doctor, New Run-Off 
12 TOOLS 1 Archive, Directed I/0, date, pre-processor 
13 MARTZ LIBRARY More utilities 
14 CITADEL 1 -Computer Bulletin-Board, Run-time 
15 CITADEL 2 Computer Bulletin-Board, Source code 
16 UTILITIES IV Binary calc, count, CRCK4, disk editor 
17 COMPILER UTILITIES META4 compiler, cross-reference, pretty-printer 
18 PISTOL Portably Implemented STack Oriented Language 
19 MISC 1 does not include kitchen sink 
20 Cuntitled) BDOS, BIOS stuff, DiskIO, disk patch, tong 
21 GAMES 2 Backgammon, Hangman, Othello, Pacman, Pong, Wumpus 
22 ROFF V4.0 Run-Off formatting-printing program 
23 RAP Text formatter 
24 TEX Text formatter for FancyFont & Epson MX-** 
25 VIDEO TERM LIBRARY & Word Processor, Tic-tac-toe, deflection game 
26 REAMS EDITOR BDS C Ed Reams Text Editor source in BDS C 
27 REAMS ED SMALL-C Ed Reams Text Editor source in Small-C 
28 AG1 Patches to Mince, Crayon & Scribble 
29 JUST LIKE MOM'S QED Editor, File encryption, Pack, Unpack 
80 6800/1800 ASM Cross-assemblers in C, disk surgery 
31 ADVENTURE Complete game source and data 
Software Tools in RATFOR 
901 DOCUMENTATION 
902 PRIMITIVES 
903 EXTRA TOOLS 1/2 
904 EXTRA TOOLS 2/2 
$05 TOOLS 1/4 A-D 
906 TOOLS 2/4 E-L 
907 TOOLS 3/4 M-R 
908 TOOLS 4/4 S-Z 
909 PRIMITAVES 1/2 A-L 
910 PRIMITAVES 2/2 M-Z 
911 DICTIONARY 1/2 A-L 
$12 DICTIONARY 2/2 M-Z 
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CUG vol. 1 

-CUG-CAT001 2K 
ASSEMBLECOM 21K 
Cc DEF 6K 
Cc SUB 1K 
cl Cc 11K 
cl COM 32K 
C2 Cc 13K 
C3 Cc 5K 
c4 Cc 6K 
c5 Cc 7K 
C6 Cc 4k 
C7 Cc 14K 
cs Cc 7K 
cg Cc 4k 
cc SUB 1K 
cL SUB 1K 
FUNCTIONASM 3K 
FUNCTIONCRL 1K 
LINK COM 13K 
READ ME 4K 
RUNTIME ASM 12K 
RUNTIME TXT 2K 
More.. 

STDLIB ASM 26K 
STDLIB ‘TXT 3K 
SUBMIT C 7K 
TIME Cc 5K 


26 file(s). 

35 directory entries remaining. 
A>STAT O: 

Bytes Remaining On O: 30k 


A> 


12/10/85 


TYPE -CUG-CAT.001 


CP/MUG-NW: C LIBRARY VOL. 1 
DESCRIPTION: SMALL C COMPILER VERSION 1 
NUMBER SIZE CRC NAME COMMENTS 

2K ~CUG-CAT.001 This file 

4K 23 CA READ ME Guide to files on this disk 
CuUG-001.1 21K FA 82 ASSEMBLE.COM Small-C assembler 
CcCuG-001.2 6K 6E 2C C ~DEF Small-C definitions 
CUG-001.3 1K A2F7 C ~SUB Small-C submit file 
CuUG-001.4 11K 7DD1 Cli eC Smal1-C Vers 1 main source 
CuG-001.5 32K CA 5C Cl -COM Small-C Compiler Vers 1 object 
CuG-001.6 13K 92 68 C2 oC Part of Small-C compiler C1.C 
CuG-001.7 5K E4 6A C3 eC Part of Small1-C compiler C1.C 
CuG-001.8 6K 1F CE C4 C Part of Small1-C compiler C1.C 
CUG-001.9 7K 03 69 C5 2c Part of Small1-C compiler C1.C 
CUG-001.10 4K 05 97 C6 C Part of Small-C compiler C1.C 
CUG-001.11 14K 34 00 C7 Cc Part of Small-C compiler C1.C 
CUG-001.12 7K DB 15 C8 <€ Part of Small1-C compiler C1.C 
CUG-001.13 4K 30 C3 C9 oC Part of Small1-C compiler C1.C 
CUG-001.14 1K 4D 66 CC -SUB C-Compiler compile submit file 
CuG-001.15 1K E4 DE CL -SUB C-Compiler link submit file 


CUG-001.16 3K 7B 93 FUNCTION.ASM C-Compiler function assembly source 
CUG-001.17 1K FD 48 FUNCTION.CRL Relocatable of FUNCTION.ASM 
CUG-001.18 13K EE 2E LINK -COM Small-C linker 

CUG-001.19 12K 31 A9 RUNTIME .ASM Small-C runtime assembly source 
CUG-001.20 2K 23 E6 RUNTIME .TXT 

CUG-001.21 26K 9A 8A STDLIB .ASM Small-C standard library asm source 
CUG-001. 22 3K 06 5B STDLIB .TXT 

CUG-001. 23 7K 6D 3E SUBMIT .C Small1-C submit source 

CUG-001.24 5K C7 68 TIME oC 


e-ASM Assembly source code 

oC C Program source code 

-CRL Relocatable code 

-COM Compiled program 

-DEF Defenitions 

-SUB Submit file 

TXT Text (Documentation) 
RNC 4/84 


O> 


Cc. 


TYPE READ.ME 
def 


cl.c 


Ox. 


c3.¢c,c445 


c5.c-c7.c 


c8.c-c9.c 


Cc. 


sub 


cl.sub° 


cc.sub 


runtime.asm . 


runtime.txt 


stdlib.asm 


ie 


stdlib.txt 


function.asm 


function.crl 


Has all static and macros defintion for "C" compiler 

Has main line and opening text plus #include, 

#if, #nif,error Summary, dumpingt extern , 

and static area 

Has new function handleing ,statement parser, 

some ending charater check routines, compound statement, 
if statement, while statement,switch statement, for statement 
return statement, break statement, contiune statement, 
#fasm statement, #endasm 

have needed utils and other little function 

expression handler 

code generation for the compiler 


submit script to compile the current version of the compiler 
and link it. 


submit script to link the compiler if all crl file exist 


submit script to run the compiler used by typeing 
"submit filename" 


source to runtime routines needed by the compiler 
object of runtime.asm 


a few assembler function that one needs ... 
thing link puts,putch,gets,getch, ... 


object of stdlib.c 


needed assemble function for speed... 
strcepy,strcat,strpos,strien 


bdsc object format of this function 


cl.com compile version of the compiler 

assemble.com assembler needed to assemble output from the c compiler 
link.com link to link files 

submit.c a copy of a submit written in c that aollow nesting of submits 
time.c a copy of a program that get a d set time for qt clock board 
what my version of smallc has: =S*St*=~=CS~=“‘—s~=S~s~*~“‘“s=s=CS<~C<S;S;«SCSSStStSStSSS 


statements: 


#asm 


#endasm 


#define 


#ifdef 


#ifndef constant 


allow assembler code to follow 
to end assembler code and go back to c 
macro definition 

constant see if defined 


see if not defined 


finclude <ftile name> 


int 


char 


{} 


if (expression) statement; 


while (expression) 


identifier,... 


identifier,.. 


include source from file fname 
define a 16 bit integer 

define a 8 bit unsigned value 

defines a block of statements 


{else statement; } 


statement; 


for(expression; expression; expression) statement; 


switch (expression) 


{ cas 


return fexpression}; 


break; 


contiune; 


operators: 


* 


expression 
lvale 
expression 


expression 


o~ 


++ lvalue 
-~- lJvalue 
lvalue ++ 
lvalue -- 
expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 


expression 


expression 


/ 
% 
<< 
>> 


& 


a 


&& 
tl 
< 


expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 
expression 


expression 


e constant: default : } 


expression > expression 
expression <= expression 
expression >= expression 
+ ! expression 
lvalue = expression 
lvalue += expression 
lvalue -= expression 
lvalue *= expression 
lvalue /= expression 
lvalue %= experession 
lvalue &= expression 
lvalue “= expression 
lvalue != expression 
constant: 
n just a base ten number 


\n,\r,\t,\b,\f£ just a few character constant 


Qo». \VyeN\" NE 


\nnn a base 8 number 


Oxnn a base 16 number 
compiler used to compile programs is bdsc 1.41 
memory in system is 56k 

Mike Bernson 

2103 Glencoe Hills APT 6 

Ann Abror, Mi 48104 


Phone 313-973-6404 or 
313-996-0646 


if any problem come up please give me a call or write 


O> 


o~ 
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CUG vol. 
-CUG-CAT002 3K 
ABS Cc 1K 
CALL AAA 7K 
CALL ASM 7K 
CANT Cc 1K 
cc DEF 4K 
Cccl Cc 5K 
Ccll Cc 7K 
CC12 Cc 7K 
CCc13 Cc 8K 
CCc2 Cc 2K 
Cc21 Cc 6K 
CC22 Cc 8K 
cc3 Cc 2K 
CC31 Cc 7K 
CC32 c 6K 
CC33 Cc 5K 
cc4 Cc 1K 
cc41 Cc 6K 
CC 42 Cc 8K 
DTOI Cc 1K 
GETWRD C 1K 
More.. 
ITOD Cc 1K 
ITOU Cc 1K 
ITOX Cc 1K 
LEFT Cc 1K 
LIB Cc 1K 
LIB H 1K 
ouT C 1K 
PAGE Cc 1K 
PRINTF C 2K 
SIGN Cc 1K 
STDIO Cc 4K 
STDIO H 3K 
STDIOL 4H 2K 
STRCMP C 1K 
UTOI Cc 1K 
XTOI Cc 1K 
38 file(s). 
26 directory entries remaining. 
D>STAT O: 


Bytes Remaining On O: 115k 


D> 


2 


2/11/86 


TYPE O:-CUG-CAT.002 


CP/MUG-NW: C LIBRARY VOL. 2 

DESCRIPTION: SMALL C COMPILER VERSION 2 

NUMBER SIZE CRC NAME COMMENTS 
3K ~CUG-CAT.002 This file 

CUG-002.1 1K EB 02 ABS oC 


CuUG-002.2 7K 81 F9 CALL ~AAA 
CUG-002.3 7K 81 F9 CALL -ASM 
CuUG-002.4 1K OD 58 CANT eC 

CuUG-002.5 4K 17 1E cc ~DEF Small-C 2 Compiler definitions 


CUG-002.6 5K 47 4F CCl eC Part of Small1-C 2 Compiler 
CUG-002.7 7K D8 49 CCll a Part of Small-C 2 Compiler 
CUG-002.8 7K O08 2B CC12 <€ Part of Smal1-C 2 Compiler 
CUG-002.9 8K E2 AC CCl13 <C Part of Small-C 2 Compiler 
CUG-002.10 2K D5 EA CC2 iG Part of Small-C 2 Compiler 
CUG-002.11 6K 5D 53 CC21 Cc Part of Small1-C 2 Compiler 
CUG-002.12 8K F5 Bl CC22 eG Part of Small-C 2 Compiler 
CUG-002.13 2K FO 9C CC3 -C Part of Small1-C 2 Compiler 
CUG-002.14 7K 63 71 #42©C3i1 .C Part of Small1-C 2 Compiler 
CuG-002.15 6K 40 C9 CC32 Cc Part of Smal1-C 2 Compiler 
CUG-002.16 5K OF EA CC33 .C Part of Small1-C 2 Compiler 
CUG-002.17 1K AO 49 CC4 sc Part of Smal1-C 2 Compiler 
CUG-002.18 6K FE BO CC4l1 oC Part of Small1-C 2 Compiler 
CUG-002.19 8K 6C 80 CC42 aC Part of Smal1-C 2 Compiler 
CUG-002.20 1K AF 1A DTOI C Part of Smal1-C 2 Compiler 
CUG-002.21 1K CO D9 GETWRD .C Part of Smal1-C 2 Compiler 
CUG-002.22 1K DO 9B ITOD JC Part of Small-C 2 Compiler 
CUG-002. 23 1K 66 05 ITOU aC Part of Small-C 2 Compiler 
CUG-002.24 1K Cl 73 ITOX oC Part of Small1-C 2 Compiler 
CUG-002.25 1K BF 9E LEFT aC Part of Small-C 2 Compiler 
CUG-002. 26 1K D8 2F LIB eC Smal1-C 2 Compiler library source 
CUG~002.27 1K 1F 00 LIB .B Small1-C 2 Compiler library header 
CUG-002. 28 1K 08 02 oUT re & Part of Smal1-C 2 Compiler 


CUG-002. 29 1K 88 EF PAGE a Part of Small-C 2 Compiler 
CUG-002.30 2K 67 69 PRINTF .C Part of Small-C 2 Compiler 
CUG-002.31 1K £E3 2F SIGN eC Part of Small1-C 2 Compiler 
CUG-002.32 4K 83 12 STDIO éc Part of Small-C 2 Compiler 
CUG-002.33 3K 07 AO STDIO oH Small1-C 2 Compiler standard I/O head 
CUG-002.34 2K 22 C5 STDIOL .H Small1-C 2 Compiler long I/O header 
CUG-002.35 1K 5E EE STRCMP .C Part of Small-C 2 Compiler 
CUG-002.36 1K 1F 38 UTOI a oe Part of Small-C 2 Compiler 
CUG-002.37 1K 62 40 xXTOI ac Part of Small-C 2 Compiler 


eAAA .ASM Assembler source code 


oC C Program sorce 
-DEF Definitions 
eH Header for C program 
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D> 


H-2FOR soel 52 
** Small-C Compiler Version 2.0 
** Copyright 1982 J. E. Hendrix 
* 


** Macro Definitions 


[* 

** compile options 

*/ 

#define PHASE2 7* 2nd and later compiles */ 
#define SEPARATE /* compile separately */ 

#define OPTIMIZE /* compile output optimizer */ 
#define NOCCARGC /* no calls to CCARGC */ 

/* #define HASH /* use hash search for macros */ 
#define SMALL_VM /* uses Small1-VM interface */ 
#define CMD_LINE /* command line run options */ 
#define DYNAMIC /* allocate memory dynamically */ 


#define POLL /* poll for operator interruptions */ 
#define PDS /* uses PDS aSsembler and loader */ 
#define COL /7* terminate labels with a colon */ 


/* #define TAB 9 7* put out tabs of this value */ 
#define UPPER /* force symbols to upper case */ 
#define LINK /* will use with linking loader */ 


/* 
** machine dependent parameters 
*/ 


#define BPW 2 /* bytes per word */ 

#define LBPW 1 /* Jog2(BPW) */ 

#define SBPC 1 /* stack bytes per character */ 
‘W define ERRCODE 7 /* op sys return code */ 


/* 
** symbol table format 
*/ 

#define IDENT 0 
#define TYPE 1 


#define CLASS 2 
#define OFFSET 3 
#define NAME 5 
#define OFFSIZE (NAME-OFFSET) 
#define SYMAVG 10 
#define SYMMAX 14 


/* 
** symbol table parameters 
*/ 


#define NUMLOCS 25 

#define STARTLOC symtab 

#define ENDLOC (symtab+ (NUMLOCS* SYMAVG) ) 

#define NUMGLBS 180 

#define STARTGLB ENDLOC 

#define ENDGLB (ENDLOC+ ( (NUMGLBS-1) *SYMMAX) ) 

#define SYMTBSZ 2770 /* NUMLOCS*SYMAVG + NUMGLBS*SYMMAX */ 


@’* 

=m ¥** System wide name size (for symbols) 
*/ 
#define NAMESIZE 9 
#define NAMEMAX 8 


/* 
** possible entries for "IDENT" 


“7/ 

#define LABEL 0 

#define VARIABLE 1 

#define ARRAY 2 

#define POINTER 3 

#define FUNCTION 4 
o:: 

** possible entries for "TYPE" 

ae low order 2 bits make type unique within length 


bls high order bits give length of object 
*/ 
/* LABEL 0 */ 


#define CCHAR (1<<2) 
#define CINT (BPW<< 2) 


/k 
** possible entries for "CLASS" 
*/ 

/* LABEL 0 */ 


#define STATIC 1 
#define AUTOMATIC 2 
#define EXTERNAL 3 


/* 
** "switch" table 
* 


#ifdef PHASE2 
#define SWSIZ (2*BPW) 
#define SWTABSZ (25*SWSIZ) 


#else 

#define SWSIZ 4 

#define SWTABSZ 100 

#endif - 

/k 

** "while" statement queue 

*/ 

#define WOTABSZ 30 

#define WQSIZ 3 

#define WOMAX (wq+WOTABSZ-WOSIZ) 
/* 

** entry offsets in while queue 
*/ 


#define WOSP 0 
#define WOLOOP 1 
#define WOEXIT 2 


/* 

** literal pool 

*/ 

#define LITABSZ 700 
#define LITMAX (LITABSZ~-1) 


/* 
** input line 


*/ 
Oyoerine LINEMAX 80 
#define LINESIZE 81 


/* 

** output staging buffer size 
*/ 

#define STAGESIZE 800 


TQGC INE whee ros aay 


/* 
** macro (define) po 
*/ 

#ifdef HASH 

#define MACNBR 90 
#define MACNSIZE 990 


#define MACQSIZE 450 
#felse 
#define MACQSIZE 950 
#endif 


SB Apso L4 wa, 


ol 


/* 90*(NAMESIZE+2) */ 
#define MACNEND (macn+MACNSIZE) 
7* 90%5 */ 


#define MACMAX (MACQSIZE-1) 


/* 
** statement types 
*/ 

#define STIF 
#define STWHILE 
#define STRETURN 
#define STBREAK 
#define STCONT 
#define STASM 
#define STEXPR 

/* #define STDO 

/* #define STFOR 
/* #define STSWITCH 
#define STCASE 11 
#define STDEF 12 
/* #define STGOTO 


eo” 


NOU BWNHH 


8 /* 
9 /* 
10 /* 


13 /* 


compile 
compile 
compile 


compile 


"do" logic */ 
"for" logic */ 
"switch/case/default" logic */ 


"goto" logic */ 


POLY-yu 
#PY319 


K&M Company 
TORRANCE, CA 90503 


S| 


oO 


CUG vol. 
-CUG-CAT003 3K 
ALIFE ASM 8K 
ALIFE CRL 2K 
BUGS Cc 8K 
CATALOG CG3 2K 
DMF Cc 8k 
EUCLID C 1K 
EZ1 ANS 2K 
FALLOUT C 6K 
FLYBY Cc 2K 
HARD1 ANS 2K 
HISTORY CG3 3K 
HSTONE C 13K 
IQUIZ Cc 8K 
IQUIZ DAT 23K 
JOTTO Cc 8K 
JOTTO WDS 4k 
LIFE Cc 9K 
LIFE DAT 13K 
LINES Cc 10K 
MED1 ANS 2K 
MM Cc 5K 
More.. 
NLIFE Cc 7K 
NLIFE HLP 4k 
POLISH C 2K 
PRESSUP C 8K 
R2 MAP 1K 
RALLY Cc 11K 
RALLY MAP 2K 
STD H 7K 
STONE Cc 10K 
TTT Cc 8K 
TV ANS 2K 
XPERT1 ANS 4K 
XWORD Cc 15K 
YAHTZEE C 12K 
YAHTZEE HLP 4K 
37 file(s). 
26 directory entries remaining. 
D>STAT O: 


Bytes Remaining On O: 2k 


D> 


3 


2/11/86 


TYPE O:-CUG-CAT.003 


CP/MUG-NW: C LIBRARY VOL. 3 
DESCRIPTION: GAMES 1 
NUMBER SIZE CRC NAME COMMENTS 

3K -CUG-CAT.003 This file 

3K 7F 12 HISTORY .003 Credits for this volume 
CUG-003.1 8K 9A 60 ALIFE «ASM Part of NLIFE. 280 code 
CUG-003.2 2K 93 01 ALIFE -CRL Assembled vers. link with NLIFE 
cuG-003.3 8K 92 AF BUGS Cc Game for Heath/Zenith 
CuG-003.4 8K OA A8 DMF Cc Header for David Fogg games 
CuG-003.5 1K B3 7D EUCLID .C Finds greatest common denominator 
CUG-003.6 2K 8B 29 E21 e-ANS Part of IQUIZ 
CUG-003.7 6K F9 3B FALLOUT .C Extension of FLYBY 
CuG-003.8 2K 08 1C FLYBY ac Graphic demo for Heath/Zenith. 
CUG-003.9 2K 9D 01 HARD -ANS Part of IQUIZ 
CUG-003.10 13K D1 30 HSTONE .C Heath/Zenith version of STONE 
CUG-003.11 8K 9B 51 IQUIZ .C Q/A Game for Heath/Zenith 
CUG-003.12 23K 87 64 IQUIZ DAT Part of IQUIZ 
CUG-003.13 8K 8E 92 JOTTO Cc Word Game for Heath/Zenith 
CUG-003.14 4K OF 76 JOTTO eWDS Part of JOTTO 
CUG-003.15 9K B3 F4 LIFE a Life for non-Heath/Zenith 
CUG-003.16 13K BA OD LIFE -DAT Screen images for NLIFE 
CUG-003.17 10K 05 01 LINES aC Visual demo for H19/219 
CuG-003.18 2K 7E 76 MEDI eANS Part of IQUIZ 
CuG-003.19 5K 4A CC MM .C Mastermind Game 
CUG-003.20 7K 80 54 NLIFE oC New H19/219 version of LIFE 
CUG-003.21 4K 31 20 NLIFE -HLP Help for NLIFE 
CUG-003.22 2K EC AD POLISH .C RPN Demonstration 
CUG-003. 23 8K C8 45 PRESSUP .C Peg Game 
CUG-003.24 1K 8B D5 R2 -MAP Part of RALLY 
CUG-003.25 11K 37 82 RALLY oC Road Game for H19/219 
CUG-003. 26 2K 53 8E RALLY MAP Part of RALLY 
CUG-003.27 7K AS FF STD eH Header for XWORD, YAHTZEE, IQUIZ 
CUG-003.28 10K F5 7F STONE eC WARI for TTY type terminals 
CUG-003.29 8K 38 30 TTT .C Tic-Tac-Toe Game 
CuUG-003.30 2K 17 DA TV -ANS Data file for XWORD 
CUG-003.31 4K 66 42 XPERT1 .ANS Data file for XWORD 
CUG-003.32 15K AF 71 XWORD oC Crossword puzzle Game for H19/219 
CUG-003.33 12K 01 C7 YAHTZEE .C Classic die/poker Game 
CUG-003.34 4K 52 CC YAHTZEE .HLP Help for YAHTZEE 


Cyclical Redundancy 


RNC 4/84 


D> 


» MAP 


Check (CRC) 


-ANS .WDS 


generated with CRCK4.COM 


Assembler source code 

Compiled relocatable code (from C) 
C source code 

Header for C source files 

Help file 

Data files 


POLY-vu 
#PY 319 


K&M Company 
TORRANCE. CA 90503 


is) 


-CATALOG021 
-CUG-CAT021 
BG Cc 
BUGS Cc 
CASIO Cc 
CASIO REC 
FALLOUT C 
FISH Cc 
HANGMAN C 
NLIFE Cc 
NLIFE DAT 
NLIFEA CRL 
OTHELLO C 
PACDEFS H 
PACMAN C 
PACMAN REC 
PACMONSTC 
PACSCOREC 
PACUTIL C 
PACUTILSC 
PPONG Cc 
RALLY Cc 
More.. 
RALLY MAP 
STONE Cc 
WAVY Cc 
WUMPUS C 
YAHTZEE C 
YAHTZEE HLP 
28 file(s). 


13K 
4K 


CUG vol. 21 


35 directory entries remaining. 


D>STAT O: 


Bytes Remaining On O: 45k 


D> 


2/11/86 


TYPE O:-CUG-CAT.021 


CP/MUG-NW: C LIBRARY VOL. 21 
DESCRIPTION: GAMES 2 
NUMBER SIZE CRC NAME COMMENTS 
2K -CUG-CAT.021 This file 
CUG-021.1 19K CD 3D BG .C Backgammon game 
CUG-021.2 8K OE D8 BUGS oC Update from CUG-003.3 
CUG-021.3 8K Bl DO CASIO PKC} Casio watch game 
CUG-021.4 1K 3E 30 CASIO -REC Data for CASIO.C 
CUG-021.5 6K OA 8B FALLOUT .C Update from CUG-003.7 
CUG-021.6 10K 89 E7 FISH oC Go fish game 
CUG-021.7 4K 32 B7 HANGMAN .C Hangman word game 
CUG-021.8 7K F2 A2 NLIFE eC Update from CUG-03.15 
CUG-021.9 13K BA OD NLIFE -DAT Data for NLIFE.C 
CUG-021.10 2K 93 01 NLIFEA .CRL Part of NLIFE.C 
CUG-021.11 14K 4E 59 OTHELLO .C Othello game 
CUG-021.12 5K Bl F5 PACDEFS .H Part of PACMAN.C 
CuG-021.13 7K 25 DD PACMAN .C Pacman game 
CuG-021.14 1K 3A 3D PACMAN .REC Part of PACMAN.C 
CuG-021.15 6K 78 B4 PACMONST.C Part of PACMAN.C 
CUG-021.16 2K B4 70 PACSCORE.C Part of PACMAN.C 
CUG-021.17 9K 37 C5 PACUTIL .C Part of PACMAN.C 
CUG-021.18 9K 9B 7E PACUTILS.C Part of PACMAN.C 
CuUG-021.19 7K F9 A5 PPONG .C Ping-Pong game for H/Z-19 
CUG-021.20 11K 12 AC’ RALLY Cc Update from CUG-003.25 
CUG-021.21 2K 53 8E RALLY eMAP Part of RALLY.C 
CUG-021.22 13K 14 B2 STONE oC Update from CUG-003.28 
CUG-021.23 2K 33 BD WAVY «C Wavy lines for H/Z-19 
CUG-021.24 9K 8D Cl WUMPUS .C Wumpus game 
CUG-021.25 13K BB 2C YAHTZEE .C Yahtzee dice game 
CUG-021. 26 4K 4A 71 YAHTZEE .HLP Help for YAHTZEE.C 
oC C program source 
-CRL Relocatable code 
-MAP .DAT Data file 
eH Header for C program source 
-HLP Help file 


RNC 4/84 


D> 


POLY-Vy 
#PY419 


K&M Company 
TORRANCE,CA $0503 


)' 


.* 


-CUG-CAT031 
ADVCOMP SUB 
ADVENT C 

ADVENT COM 
ADVENT CRL 
ADVENT 4H 

ADVENT] DAT 
ADVENT2 DAT 
ADVENT3 DAT 
ADVENT4 DAT 
ADVENTS DAT 
ADVENT6 DAT 
ADVLINK SUB 
CATALOG DOC 
DATABASEC 

DATABASECRL 
EADVENT C 

EADVENT COM 
EADVENT CRL 
ENGLISH C 

ENGLISH CRL 
ENVIRON DOC 


More.. 
HISTORY DOC 
ITVERB C 
ITVERB CRL 
MKADVENTSUB 
MKEADVENSUB 
MKSAVEADSUB 
READ ME 
SAVEADV C 
SAVEADV COM 
SAVEADV CRL 


TURN Cc 
TURN CRL 
VERB Cc 
VERB CRL 


36 file(s). 


14K 
10K 
13K 

8K 


CcUG vol. 


25 directory entries remaining. 


D>STAT O: 


Bytes Remaining On O: 35k 


D> 


jee Mtn .- 


31 


oe ee 


2/11/86 


TYPE O:-CUG-CAT.031 


CP/MUG-NW: 
DESCRIPTION: 
NUMBER SIZE 

3K 

1 
CuG-031.1 1K 
CUG-031.2 5K 
CUG-031.3 10K 
CUG-031.4 5K 
CUG-031.5 6K 
CUG~-031.6 18K 
CUG-031.7 7K 
CUG-031.8 1K 
CUG-031.9 4K 
CUG-031.10 6K 
CUG-031.11 18K 
CUG-031.12 1K 
CUG-031.13 7K 
CUG-031.14 5K 
CuG-031.15 1K 
CUG-031.16 24K 
CUG-031.17 1K 
CUG-031.18 3K 
CUG-031.19 2K 
CUG-031.20 3K 
CUG-031.21 1K 
CUG-031.22 4K 
CUG-031. 23 3K 
CUG-031.24 1K 
CUG-031.25 1K 
CUG-031. 26 1K 
CUG-031.27 1K 
CUG-031.28 7K 
CUG-031.29 2K 
CUG-031.30 14K 
CUG-031.31 10K 
CUG-031.32 13K 
CUG~031.33 8K 
RNC 4/84 


D> 


CRC 


28 


C LIBRARY VOL. 31 


ADVENTURE IN C 


NAME 


-CUG-CAT.031 
READ «ME 


ADVCOMP .SUB 
ADVENT .C 

ADVENT .COM 
ADVENT .CRL 
ADVENT .H 

ADVENT] .DAT 
ADVENT2 .DAT 
ADVENT3 .DAT 
ADVENT4 .DAT 
ADVENT5 .DAT 
ADVENT6 .DAT 
ADVLINK .SUB 
DATABASE.C 

DATABASE.CRL 
EADVENT .C 

EADVENT 
EADVENT .CRL 
ENGLISH .C 

ENGLISH 
ENVIRON 
HISTORY 
ITVERB .C 

ITVERB .CRL 
MKADVENT. SUB 
MK EADVEN. SUB 
MKSAVEAD. SUB 
SAVEADV .C 

SAVEADV .COM 
SAVEADV .CRL 
TURN eC 

TURN 
VERB eC 
VERB 


COMMENTS 


This file 
General notes on revisions 


Submit file to compile ADVENTURE 
ADVENTURE game 

ADVENTURE game 

ADVENTURE game 

Header file for ADVENT programs 
Adventure data file 

Adventure data file 

Adventure data file 

Adventure data file 

Adventure data file 

Adventure data file 

Submit file to link ADVENTURE 

Data manipulation sub-program 

Data manipulation sub-program 
ADVENTURE main operating link 
ADVENTURE main operating link 
ADVENTURE main operating link 

Part of ADVENTURE 

Part of ADVENTURE 

Adventure env description & run notes 
History of ADVENTURE 
Part of ADVENTURE 
Part of ADVENTURE 
Submit file to link 
Submit file to link 
Submit file to link 
ADVENTURE game save 
ADVENTURE game save 
ADVENTURE game save 
Part of ADVENTURE 
Part of ADVENTURE 
Part of ADVENTURE 
Part of ADVENTURE 


ADVENTURE 
ADVENTURE 
ADVENTURE 
link program 
link program 
link program 


C Program source code 
Relocatable code 

Compiled program 

Data file 

Documentation 

Header for C program source 
Submit file 


Doc 


~~------- CATALOG.DOC ----------- 


Filename.ext Size Description 


TYPE O:CATALOG. 
CATALOG.DOC 
ADVCOMP.SUB 1K 

DVENT.C 5K 


“WADVENT.COM 10K 
ADVENT. CRL 5K 
ADVENT. H 6K 


ADVENT1.DAT 18K 
ADVENT2,DAT 7K 
ADVENT3.DAT 7K 
ADVENT4.DAT 4k 
ADVENTS5.DAT 6k 
ADVENT6.DAT 18K 
ADVLINK. SUB 1K 


DATABASE.C 7K 
DATABASE.CRL 5K 
EADVENT.C 1K 
EADVENT.CRL 1K 
EADVENT.COM 24K 


ENGLISH.C 3K 
ENGLISH.CRL 2K 
ENVIRON.DOC 3K 


ITVERB.C 4K 
ITVERB.CRL 3K 
QQRKADVENT.SUB 1K 
“WMKEADVEN.SUB 1K 
MKSAVEAD.SUB 1K 
READ.ME 
SAVEADV.C 1K 
SAVEADV.COM 7K 
SAVEADV.CRL 2K 


TURN.C 14k 
TURN.CRL 10K 
VERB.C 13K 
VERB.CRL 8K 


D>TYPE O:READ.ME 
NOTES ABOUT 


Catalog of files added/changed on disk 

Submit file for compilations of ADVENTURE programs 
Main Adventure Program, in C 

Compiled and linked version call up by ADVENT 


Only significant change, to V 1.43 disk buffering 
this is header file for ADVENTURE DO NOT USE 
BDSCIO.H ! 

Furnished adventure data file, no change 

ditto 

ditto 

ditto 

ditto 

ditto, don't forget you need these to run 

Submit file for linking up three ADVENTURE chains to 

get .COM files 

Source for data manipulation sub-programs 


Source for main operating link of ADVENTURE 

COM file, called in by EXEC from ADVENT. By the way, 
it works OK when in the b: disk with V 1.43? 

Another Source 

Description of original environment, plus notes added 
when running under 1.43 

Another Source 


These three are original link subs - won't work under 
under V 1.43, see ADVLINK.SUB instead. 


General notes on the revision and revisor 
Source of link used to save a game 
Another source of sub~programs 


Another source 


MODIFICATION TO PROGRAMS 


These modifications (trivial) and compilation/checkout 


were done by: 


L. C. Calhoun PE 
257 South Broadway 
Lebanon, Ohio 45036 <513> 932-4541/433-7510 


The only change required was in ADVENT.H, to adjust the buffer 


call outs to fit 


the standard BDS-C Version 1.43 utilities. 


Compilation and Linking calls were changed to accomodate 
the V 1.43 changes. More notes will be found in ENVIRON.DOC. 
The game was brought up, and played for a few minutes to ensure 
that it was no worse than before. I didn't have time to do 
any checks on the game's performance as a game--but then I wasn't 
ked to. It behaved, for that short time, as did the original 
@s;pVENT.COM on the disk from the BDSCUG. 
*" phe o1d COM files have been deleted, and the .C files replaced. 
CRL, a new pair of submit files, and documentation files have been 


added. 


p> 


TYPE O:ENVIRON.DOC 
Notes on Adventure Environment 
Written April 26, 1981 


This disk was written and and compiled under version 1.3x and 
will NOT compile under version 1.4 and later without changes to the 
Curce. Specifically dbuff in advent.h on or about line 134 must be 

‘Wdeclared so that it is compatible with the 1.4 file i/o. The com files 

on the disk will require at least a 46k system to execute, but 
recompiling under 1.4 will add about 1k to the memory requirements 
(except that 1.4 produces tighter code). 

The com files provided were debugged on a system including 
a 48k Altair equipped with 2 Micropolis drives, and a Processor 
Technology VDM. 

To begin play, type advent. To resume a saved game type 
"advent -r". 


Added notes on making this ADVENTURE work in BDS-C Version 1.43 
Environment written 17 May 1981 by L. C. Calhoun. 


At Robert Ward's request, I brought this program up on 
the 1.43 compiler. Only one change was required..to add the 
small section on buffering from BDSCIO.H to ADVENT.H, and to 
change dbuff[134] in ADVENT.H to dbuff[BUFSIZ]. I did review 
the other program files for potential changes, and added a 
title and note to the head of each for the record. The compile 
and link control syntaxes differ between V 1.4 and older versions. 
I made the appropriate changes, and created two submit files; 
ADVCOMP.SUB and ADVLINK.SUB. These must (of course) run on 
disk a:, but they are set up for all the c utilities to be on 
disk a: and the actual c programs with their .CRL files to be 
on b:. Just PIP these two sub files over to the a: disk where 

Qs, cc2, C.CCC, CLINK, DEFF* etc. hang out. Only one file 
needs to be read two times during linkage ~- TURN.CRL while 
EADVENT.COM is being linked. Otherwise, it went smoothly 
in conversion. 


Mr. Jaeger (me too, I must admit) was worried that 
the greater buffer size used in the standard V 1.43 library 
would have a bad effect on the program length. I compiled 
without the -o option for optimization. Lo and behold, 
the program appears to be considerably shorter. I was able 
to external set the data (-e6A00) much lower than in the 
submit files supplied. I could have even gone lower. 

I compiled a second time with the e option in CCl to -e6A00, 
see ADVCOMP.SUB. Dog gone if the code didn't end at 5EC8. 
However, the variables end at 7CAl even with the -e6A00, 

so I didn't bother. 


The re-compiles were done on an ALTAIR 8800B, with 

a 60K CPM 2.2 system, ADM~3A display, and TARBEL single side 

single density controlling four Shugart 801R's. I checked 

the elboeroom callouts during compile, and the least amount 

of elboeroom was 20K whilst compiling TURN.C. So, it appears 

that the re-compiled version will compile and run on 

a 40K system with about 4K of stack space. You can pick 

up another 2K of stack space by editing the ADVCOMP.SUB file 
or the option -e6000 if it's worthwhile. Thank you Mr. Zolman. 


“J 


D> 


TYPE O:HISTORY.DOC 


HISTORY FILE FOR ADVENTURE IN C 


09 Jan 1982 Greg Huntzinger 


D> 


5775 Leetsdale Dr. 
Suite 699 
P.O. Box 22557 
Denver, CO 80222 
<303> 753-0488/452-4919 ext 307 
added this history file 
fixed spelling and typeo errors in-- 
ADVENT1.DAT 
ADVENT2.DAT 
ADVENT6.DAT 


